Docs

Get your team into a shared session in minutes.

Install the CLI, launch a drive, and bring your team into one live AI coding session. Here is everything you need to start, plus the concepts and commands to go deeper.

Quickstart

Two ways in, and you can mix them: everything works in your browser at coshell.ai, and from your terminal with the CLI. Each step below shows both.

1

Get in

Open coshell.ai and sign in to launch a drive in your browser, or install the CLI and sign in from your terminal. GitHub sign-in works either way.

$ curl -fsSL https://coshell.ai/install | bash$ coshell login
2

Create a drive

A drive is your team's shared workspace. Create one from the dashboard, or from the terminal. Name it after a project or workstream.

$ coshell drives create my-project
3

Open the live session

Your drive opens in the browser with the agent, the terminal, and an integrated preview of your running app. Prefer the terminal? Attach to it instead. Either way you are in the same live session.

$ coshell attach my-project
4

Bring your team in

Invite a teammate to the drive. They join from a browser, or run coshell attach my-project, and you are in the same live session, prompting the same agent and watching the same work land.

Attach with your stock OpenCode CLI

Coshell does not fork the protocol. The OpenCode CLI you already have attaches to a drive unchanged, so you are never locked to our interface.

$ coshell token new my-project$ export OPENCODE_SERVER_PASSWORD=cosh_pat_…$ opencode attach https://your-drive.coshell.ai

You can also mint a per-drive token from the dashboard, under CLI access.

Core concepts

Drives

A drive is your team's persistent cloud workspace: the repo, the environment, and your sessions, kept warm between sessions. Pricing is free to self-host, so teams keep a drive per project.

Live sessions

Inside a drive, everyone works in the same live session: one agent, one filesystem, one terminal, and an integrated browser preview. It is closer to a Google Doc than to git.

Overlap

When two agents reach for the same lines of the same file, Overlap catches it and steers the second edit before it clobbers the first. It works across every model and fails open, so it never blocks your editing.

Presence and follow

See who is in the session and what they are doing. Follow a teammate to watch them steer the agent in real time.

Integrated browser preview

A drive runs your app and shows it live in an integrated browser preview. When the agent ships a change, everyone in the session sees it reload, so you review the running app together, not a diff.

Your models

Run 70+ models on your own keys, use the included models, or, on Enterprise, route through Amazon Bedrock in your own AWS account. Admins choose the allowed set per drive.

Per-session privacy

Every session has its own access control: private to you, shared with named teammates, or open to the drive. See the security details.

Push to your real git

Work in a drive lands in your own repositories as normal commits and pushes, so your existing branches, reviews, and CI keep working. Nothing you build is trapped in Coshell.

CLI reference

Prefer the terminal? Everything here is also in the browser, but these are the commands you will use most. Run any command with --help for the full options.

coshell loginSign in. Add --web to sign in through the browser, including GitHub.
coshell attach <name>Open a drive in your terminal. Run coshell with no command to pick one.
coshell drivesList your drives and their status.
coshell drives create <name>Create a drive. Choose a size with --tier and a location with --region.
coshell drives info <name>Show a drive's details.
coshell drives resize <name>Change a drive's compute tier or grow its disk.
coshell drives archive <name>Archive an idle drive to cold storage; restore it on demand.
coshell drives rm <name>Permanently destroy a drive and its data.
coshell run "<prompt>"Run an agent task on a drive. Add --detach to keep it running in the background.
coshell runs / coshell logs <id> -fList agent runs, or stream a run's output live.
coshell token new <drive>Mint a per-drive access token for attaching the stock OpenCode CLI.
coshell usage / coshell billingShow this org's usage, or open the billing portal.
coshell upgradeUpdate Coshell to the latest version.

Drive sizes: large (4 vCPU, 8 GB RAM, 20 GB disk, default), standard (2 vCPU, 4 GB), and small (1 vCPU, 2 GB). See pricing for the free tier and Teams.

Docs, answered

How do I bring my own model keys?

Coshell runs 70+ models. Bring your own provider keys, use the included models, or, on Enterprise, route every model call through Amazon Bedrock in your own AWS account. Admins choose the allowed set of models per drive.

How does my work get into git?

Work in a drive lands in your own repositories as normal git commits and pushes, so your existing branches, reviews, and CI keep working as they do today. Nothing you build is trapped in Coshell: your code stays in the git you already use.

What stops two people from clobbering each other's edits?

Overlap. Everyone in a drive works on one shared filesystem, so there is no diverging copy to lose. And when two agents reach for the same lines of the same file, Overlap catches it and steers the second edit before it lands: proceed if the changes are compatible, take other lines, wait, or let the first land first. It runs across every model and fails open, so it never blocks editing.

Can I use my existing OpenCode setup?

Yes. Coshell does not fork the protocol, so the stock OpenCode CLI attaches to a drive unchanged. Mint a per-drive token with coshell token new, set OPENCODE_SERVER_PASSWORD, and run opencode attach against your drive's address.

Start a shared live session.

Launch a drive in the browser, or attach from the CLI. Your whole team works in the same live session, on the same codebase.