CLI reference

The mobsession CLI runs a real Claude Code agent in your repository and gives you a share link so others can watch live. This page covers install, requirements, the mobsession start flow, and the keys you use to drive a session.

Install

npm i -g mobsession

This adds two commands to your path, mobsession and the short alias mss. They are identical; use whichever you prefer.

mobsession --version
mss --version

Requirements

• Node.js 22 or newer.
• Claude Code installed and signed in. The agent runs on your own Claude subscription.

The agent works in the directory where you run the command, so start from the root of the repo you want to work in.

Start a session

cd path/to/your-repo
mobsession start

MobSession asks for the orchestrator's name, spawns a Claude Code agent in your current directory, and prints a share link:

mobsession.ai/s/<code>

Share that link so others can follow along in their browser. For a full walkthrough, see the quickstart.

Drive the session

The terminal is your control surface.

Key	Action
Enter	Send the prompt you have typed
ESC	Interrupt the current turn
Ctrl+C	End the session

For what you and your viewers see during a session, read the interface.

Commands

Command	Description
mobsession	The CLI entry point.
mss	Short alias for mobsession.
mobsession start	Start a session in the current directory.

Early access

These are not generally available yet. Do not rely on them in scripts or automation until they ship, and expect names and behavior to change.

• Flags for accounts and teams.
• A non-interactive name flag, to skip the orchestrator name prompt.
• Config files for per-repo defaults.

This reference will document their exact names and behavior when they ship.

Next steps

• Quickstart: start your first session step by step.
• The interface: understand the terminal and the shared view.