Install & Run

Quickstart

npm install -g @roscoesh/cli
roscoe

That is the shortest useful path. Install once, open the TUI, and start from the dispatch board.

After launch, Roscoe opens on the home screen. Dispatch is the first stop, but the same screen also holds provider setup, Roscoe-wide settings, and channel routing.

What happens first

New repo

Choose Onboard Project and let Roscoe build the project contract before you launch any implementation lanes.

Existing repo

Choose Start Sessions, review the saved brief, then launch the main repo or a task worktree.

Shell discovery

Use roscoe —help when you need the explicit command surface for scripting or direct lane entry.

Recommended first session

1. Install the CLI globally.
2. Run roscoe.
3. If the repo has never been onboarded, choose Onboard Project.
4. If the repo is already onboarded, choose Start Sessions.
5. Stay in the TUI unless you specifically need direct CLI commands.

Commands worth knowing early

Command	Use
roscoe	Open the home TUI.
roscoe --help	List supported subcommands and flags.
roscoe onboard /path/to/project	Run onboarding directly from the shell.
roscoe profiles	Check which provider and auth profiles Roscoe can see.