Skip to Content

DocsGet started

Try it

Run turno demo to see two profiles, a gateway and the status line in a throwaway HOME.

View source

This page shows turno working before you install anything: one command, in a throwaway HOME that is removed when you leave.

npx turno-cli demo

turno demo sets up two Claude Code profiles (work for ~/code/acme, personal for every other folder), a gateway with two MCP servers, and the status line. Then it opens a shell in that HOME. Nothing there reads or changes your own HOME, and nothing signs in.

What you see

This is the demo and the first two commands to try, recorded as text:

turno demo
$ turno demo
turno demo  a throwaway HOME at /private/tmp/turno-demo-Xk3f9a

Set up ─────────────────────────────────────────────────────────────────────────
  profiles   work  for ~/code/acme,  personal  for every other folder (Claude Code)
  gateway   ● mcpd on 127.0.0.1:52222 with docs and issues, synced into both profiles
  status    the line Claude Code draws for each profile:

 ◉ work · Max  │ ⧗ ▰▰▰▱▱▱▱▱ 38%  ↺ 1h59m │ ▦ ▰▱▱▱▱▱▱▱ 12%  ↺ 3d23h │ ◔ [##--------] 23%  46k/200k
▣ acme │ ± +120 −18 │ ◈ Opus │ $0.42…
 ◉ personal · Pro  │ ⧗ ▰▰▰▱▱▱▱▱ 38%  ↺ 1h59m │ ▦ ▰▱▱▱▱▱▱▱ 12%  ↺ 3d23h │ ◔ [##--------] 23%  46k/200k
▣ personal-site │ ± +120 −18 │ ◈ Opus │ $0.42…

Try ────────────────────────────────────────────────────────────────────────────
  turno status                           the one-screen summary
  turno profile which ~/code/acme        which account a folder opens with, and why
  turno mcp list                         the servers behind the gateway
  cat ~/.claude-work/.claude.json        the gateway entries turno mcp sync wrote
  CLAUDE_CONFIG_DIR=~/.claude-work turno statusline < ~/statusline.json
                                         draw the work status line yourself
  turno undo --list                      every change turno made, each one undoable
  cd ~/code/acme && turno auto mcp list  Claude Code connects to both servers through mcpd (no sign-in)

Nothing here reads or changes your own HOME, and nothing signs in.

Opening a shell in the demo HOME. Type exit to end the demo; it then stops mcpd and removes everything.
turno demo ~ % turno
turno 0.2.0  ~ →  personal

Here ───────────────────────────────────────────────────────────────────────────
  claude   personal   folder without a rule

Profiles ───────────────────────────────────────────────────────────────────────
              5 hours    week    account
   personal   -          -       you@personal.example · pro  default
   work       -          -       you@work.example · max

Machine ────────────────────────────────────────────────────────────────────────
  gateway   ● running on port 52222
  sessions  0 live sessions
  look      turno status line · font missing (turno ui install) · unicode icons here

➜ Next  nothing to do: everything is set up

turno doctor checks each part; turno limit, session and profile show more.
turno help lists every command.
turno demo ~ % turno mcp list
MCP servers ────────────────────────────────────────────────────────────────────
  server  kind   scope   idle  profiles  state      auth  details
  docs    stdio  shared  30m   all       ○ stopped  -     /private/tmp/turno-vhs/bin/node
  issues  stdio  shared  30m   all       ○ stopped  -     /private/tmp/turno-vhs/bin/node; variants: work

The same session as a recording, with the profile picker and turno doctor:

turno demo: two profiles, one gateway, the status line, the picker and turno doctor, in a throwaway HOME

Things to try inside the demo

CommandWhat it shows
turnothe one-screen summary: this folder, accounts, gateway, what to do next
turno profile which ~/code/acmewhich account a folder opens with, and why
turno mcp listthe servers behind the gateway
cat ~/.claude-work/.claude.jsonthe gateway entries turno mcp sync wrote
turno undo --listevery change turno made, each one undoable
turno doctorevery check, with the fix under each problem

Type exit to end the demo. It stops the gateway and removes the throwaway HOME:

turno demo ~ % exit
turno demo: stopped mcpd and removed /private/tmp/turno-demo-Xk3f9a

Without a terminal

In a script or an agent session, turno demo shows what it set up and ends. turno demo --keep waits for Ctrl-C instead, and turno demo -- <command> runs one command inside the demo HOME:

npx turno-cli demo -- turno mcp list

Next

When you want it for real, install turno and follow the first five minutes.

On this page