Quick start

You need Python 3.11+ and at least two supported CLIs installed and signed in: Claude Code, Codex CLI, or opencode.

uv tool install tandem-cli   # or: pip install tandem-cli
cd your-project
tandem

Work normally in the CLI that opens. Press Ctrl-] to continue the same session in the next CLI. If you press it while the model is working, tandem waits until the response finishes; press it again to cancel the switch.

Exit normally when you're done. Come back later with:

tandem resume      # resume the latest session in this directory
tandem sessions    # find recent sessions across directories

By default, tandem opens the first usable CLI in your configured order. Use tandem --active codex or tandem --active opencode to choose another.

Why tandem?

• Keep going when a model hits its limit. Move to another CLI and continue with the same files and conversation history.
• Bring different models to the same problem. Ask another CLI for a second opinion without copying a wall of context between terminals.
• Keep the native tools you already use. Claude Code, Codex, and opencode retain their own interfaces, commands, keybindings, and MCP servers.
• Work through a single-provider outage. If another configured CLI is available, switch and continue until the affected provider recovers.

Want GPT subagents inside Claude Code too? See the GPT subagents guide. For more use cases, see Why tandem?.

How it works

┌──────────────────────────────────────────────┐
│ Work normally in a native coding CLI         │
└──────────────────────┬───────────────────────┘
                       ▼
┌──────────────────────────────────────────────┐
│ tandem keeps the other sessions in sync      │
│ locally — without calling another model      │
└──────────────────────┬───────────────────────┘
                       ▼
┌──────────────────────────────────────────────┐
│ Press Ctrl-] and continue in the next CLI    │
└──────────────────────────────────────────────┘

Only the active model runs. tandem translates its growing conversation into the other CLIs' native session formats using local file access, so they are ready when you switch. Your session stays in the CLIs' own storage plus a small local database in ~/.tandem; tandem adds no cloud sync or telemetry.

See How tandem works for transcript translation, switching, crash safety, compatibility, and data locations.

Everyday commands

Learn more

• Why tandem? — use cases, subscriptions, native tools, token visibility, and privacy
• GPT subagents — plugin setup, worker models, routing, and sandboxing
• Configuration — participants, startup arguments, the switch key, and the status bar
• How tandem works — synchronization, switching, compatibility, and local data
• Developing tandem — development setup and the harness adapter interface
• Observed session formats — Claude Code, Codex, and opencode storage formats

License

MIT