MobSessiondocs

Quickstart: your first session

Install the MobSession CLI, start a shared Claude Code session, and bring a teammate in to send the first prompt.

This guide takes you from a clean repo to your first shared prompt in a few minutes. One person starts a Claude Code agent on their machine, shares a link, and teammates send prompts that run against that same agent. Output streams live to everyone. No account needed.

Prerequisites

  • Node 22 or newer
  • Claude Code installed and signed in (the agent runs on your own Claude subscription)
  • A git repository to work in

Check your Node version:

node --version

1. Install the CLI

npm i -g mobsession

This adds the mobsession command to your PATH.

2. Start a session

From the root of your repo:

cd path/to/your-repo
mobsession start

The CLI asks for your name first, so teammates can see who's orchestrating. Once you enter it, MobSession spawns a real Claude Code agent on your machine using your own Claude subscription.

3. Share the link

When the agent is up, MobSession prints an unguessable share link:

Session ready. Share this link with your team:
https://mobsession.ai/s/ab12cd34

The code is random, so only people you send it to can join. Drop it in Slack, a DM, or wherever your team talks.

4. What your terminal shows

Your terminal mirrors the shared session, and you're a full participant, not just a host:

  • Type a prompt right in your terminal to drive the agent yourself.
  • Press ESC to interrupt the agent mid-turn.
  • Watch each turn report its duration and dollar cost as it finishes.

Prompts from you and your teammates queue and run one turn at a time, so the agent finishes one request before starting the next.

5. A teammate joins and sends a prompt

Send the link. Their side is short:

  1. They open https://mobsession.ai/s/<code> in a browser.
  2. They enter a name.
  3. They type a prompt and submit it.

That prompt joins the queue and runs against the same agent on your machine. Nothing to install, no account to create.

6. Watch it run

Output streams to every connected person in real time, your terminal included. Each turn shows how long it took and what it cost. When one turn finishes, the next queued prompt starts automatically.

That's a full session: one agent, one shared view, and a queue everyone can add to.

What's next