DocsGet started
First five minutes
Set turno up with turno init, sign in once per profile and open a folder with its account.
This page takes you from a fresh install to an agent that opens with the right account, in four commands.
turno init # finds your agents, profiles, folders and MCP servers, shows the diff,
# then starts the gateway and points every profile at it
claude-work # sign in once per profile (/login)
cd ~/code/acme && turno auto # Claude Code, with this folder's account
turno # where you stand: this folder, accounts, gateway, what to do nextRun turno init
turno init looks for installed agents, turno profiles, agent folders made by hand (~/.claude-<name>, ~/.codex-<name>), MCP servers in every agent config, and the folders each Claude Code account was used in. Then it proposes profiles, folder rules, a default and mcp.toml, and prints the whole change before it writes anything.
It asks before it adopts anything and writes everything as one change, so one turno undo <stamp> reverts it. To look without writing:
turno init --dry-runWhen there are MCP servers, turno init also offers to start the gateway as a login service (launchd on macOS, systemd --user on Linux) and point every profile at it. turno init --no-start leaves that for later (turno mcp daemon start, then turno mcp sync).
Sign in once per profile
Each profile has a launcher named after it. Run it and sign in with that account, the vendor's own way:
claude-work # then /login inside Claude CodeLaunchers go in ~/.local/bin. When that folder is not on your PATH, turno profile add prints the line to add, and turno work works meanwhile.
Open a folder with its account
cd ~/code/acme && turno autoturno auto opens the agent with the profile assigned to the current folder. It never switches accounts in silence: a missing profile or a broken config.toml stops it with the command that fixes it.
See where you stand
A bare turno is the status screen and the next step. turno doctor checks every part and names the fix under each problem:
turno demo ~ % turno doctor
System ─────────────────────────────────────────────────────────────────────────
✓ node 26.13.0
✓ claude at /private/tmp/turno-vhs/bin/claude
– codex not installed
optional: npm install --global @openai/codex
– copilot not installed
optional: npm install --global @github/copilot
– cursor-agent not installed
optional: curl https://cursor.com/install -fsS | bash
✓ secret store: macOS Keychain (security)
✓ Google Chrome installed
✓ turno 0.2.0
Config ─────────────────────────────────────────────────────────────────────────
✓ ~/.config/turno/config.toml parses
✓ ~/.config/turno/mcp.toml parses (2 servers)
Profiles ───────────────────────────────────────────────────────────────────────
✓ personal launcher ok
✓ work launcher ok
Look ───────────────────────────────────────────────────────────────────────────
✓ status line: turno statusline
✓ font: MesloLGS Nerd Font installed
Gateway ────────────────────────────────────────────────────────────────────────
✓ mcpd: reachable on port 52097 (pid 91865)
12 ok, 3 skipped in 94ms
Step by step instead
If you prefer to do each part by hand:
turno profile add work --color violet # ~/.claude-work and the claude-work command
turno profile add personal
claude-work # sign in once per profile (/login)
turno profile assign ~/code/acme work # this folder and everything under it
turno config set default personal # folders without a rule
turno mcp import --move-secrets --write # mcp.toml from the servers you already have
turno mcp daemon start && turno mcp sync # the gateway, and every profile pointed at it
cd ~/code/acme && turno auto # Claude Code, signed in as workCodex, Copilot and Cursor profiles are the same with --agent codex|copilot|cursor.
Make it the default way to open an agent
Point your terminal or editor at turno auto (or the turno-auto launcher), and every folder opens with its account.
Undo
Every command that writes keeps a copy of each file it changes:
turno undo --list # the changes turno made
turno undo <stamp> # put one backBackups older than 30 days are pruned, keeping the newest 10.
Next
- I have work and personal accounts
- Many sessions eat my RAM
- Troubleshooting, when
turno doctorflags something