v0.3.2 · Open source
Tuantuan
Your coding agents, one room.
Stop copy-pasting between terminals. Bring Claude Code, Codex, DeepSeek, OpenCode, and other coding agents into one project conversation, mention who you need, and watch them work side by side.
First launch on macOS
With Homebrew, the tap clears the quarantine flag for you, so there is no prompt:
brew install --cask bosshanz/tap/tuantuanTuantuan is not notarized by Apple yet, so the first launch shows:
“Apple could not verify “tuantuan” is free of malware that may harm your Mac or compromise your privacy.”
- Move tuantuan.app to Applications, open it once, and click Done.
- Open System Settings → Privacy & Security, scroll to Security, and click Open Anyway next to “tuantuan”.
- Confirm with your password, then click Open. Later launches open normally.
Still blocked, or told the app is damaged? Run this in Terminal, then open it again:
xattr -dr com.apple.quarantine /Applications/tuantuan.appStuck? Hand it off.
Each agent keeps its own session. A handoff carries what the next one needs.
Works with the agents you use
Tuantuan connects coding harnesses through the Agent Client Protocol. Add more from the ACP Registry.
- Claude Code
- Codex
- DeepSeek
- OpenCode
- Pi
- Grok Build
- MiniMax Code
- ACP RegistryMore agents
Built for working with several agents
Everything below is in v0.3.2.
Choose your harness
Use a local installation or install agents from the ACP Registry. Sign in the way each harness supports.
Work as a team
Mention members with @, or let a lead agent delegate, follow up, and bring results together.
Hand off with context
Handoffs carry the task, goal, decisions, and pending work. Each agent keeps its own session.
Keep native workflows
Native prompts and context management. Model, permission, reasoning, and slash-command controls come from each harness.
See the work
Attach files and images, follow streaming replies, tool calls, diffs, terminal output, plans, and permission requests.
Bring your setup
Your API providers, local Skills, and Claude plugins. Tuantuan never rewrites ~/.claude or ~/.codex.
Find past messages
Search saved conversations, jump to the original message, and return to where you were reading.
Keep files within reach
Browse attachments and agent files. Preview images, Markdown, code, and static HTML; download files or return to source messages.
See what needs you
Find pending approvals, questions, and failed replies across conversations. Handle each at its source.
Hear a session
Session Score turns a staged session into music: every reply, tool call, diff, and permission request plays a note.
Run from source
Requires Bun 1.4.2, the version used in CI.
git clone https://github.com/bosshanz/tuantuan.gitcd tuantuanbun installbun run devOpen http://localhost:5173 and follow the first-run guide.
No harness login? Try simulated replies:
TUANTUAN_MOCK_HARNESS=1 bun run devThe app starts in Simplified Chinese. Switch in 设置 → 个人资料 → 界面语言.