Bring Codex, Gemini, and Kimi CLI powered teammates into Claude Code with multi-backend routing.
Project description
Native Claude Code teammates, any LLM.
Codex, Gemini, and Kimi today. GLM, DeepSeek next — on the same team-native architecture.
Quickstart · Architecture · Roadmap
What it is
Claude Code's Agent Teams feature is built for multi-agent collaboration — but every teammate is a Claude instance. claude-anyteam makes it possible for any external agent harness to join the same team, with the same native UX, without wrapping it inside a Claude LLM.
Your Claude Code session orchestrates. External agents execute. No chat-wrapper overhead. No "Claude pretending to be Codex." No routers. Real agent CLIs, real teammates.
Quickstart
npx --yes claude-anyteam
That's the entire install. The installer:
- Detects
python3and installsuvif missing (non-interactive, no shell profile edits) - Installs the
claude-anyteamPython tool viauv tool install - Runs
claude-anyteam install(verifies tmux/psmux, probes for the OpenAI Codex CLI, Gemini CLI, and Kimi CLI, warns if any are missing or Codex is below 0.120, writes~/.claude/settings.json+~/.claude.json, records install-state for symmetric uninstall)
Restart Claude Code, enable Agent Teams mode, and create a teammate named codex-<anything>, gemini-<anything>, or kimi-<anything>:
codex-alice → routed to claude-anyteam + Codex
codex-reviewer → routed to claude-anyteam + Codex
gemini-alice → routed to claude-anyteam + Gemini CLI
gemini-reviewer → routed to claude-anyteam + Gemini CLI
kimi-architect → routed to claude-anyteam + Kimi CLI
kimi-reviewer → routed to claude-anyteam + Kimi CLI
alice → native Claude (unchanged)
Codex-, Gemini-, and Kimi-prefixed names appear in your TUI presence line exactly like native teammates. Single-terminal mode or tmux — both work.
Provider CLIs are runtime prerequisites for their prefixes: install/authenticate Codex for codex-*, Gemini for gemini-*, and Kimi for kimi-* (uv tool install --python 3.13 kimi-cli or the upstream installer, then kimi login). The probed Kimi default user-facing model slug is kimi-code/kimi-for-coding (Kimi-k2.6, 262k context).
Why it feels native
|
Real teammate protocol Not a chat wrapper. The adapter speaks Claude Code's agent-team protocol directly: mailbox I/O, atomic task claims, idle notifications, shutdown lifecycle. A Codex teammate is functionally indistinguishable from a native Claude teammate. |
Mid-task reactivity When a peer messages a working teammate, the adapter injects the message mid-turn via Codex's |
|
Cross-task memory Each new task forks from the previous task's Codex thread via |
Battle-tested parity 400 passing tests. Ten parity bugs caught by a live 4-teammate hunt (mixed Claude + Codex) and fixed. Zero accepted limitations on the protocol layer. |
Supported backends
| Backend | Teammate prefix | Status | Notes |
|---|---|---|---|
| Codex via OpenAI Codex CLI 0.120+ | codex-* |
✅ Supported today | App Server mode for mid-task steer and thread/fork; fresh-exec fallback with codex exec resume. |
| Gemini via Gemini CLI | gemini-* |
✅ Supported today | Default headless gemini --prompt ... --output-format stream-json, plus ACP via gemini-anyteam --backend acp; ACP supports `--trust default |
| Kimi via Kimi CLI | kimi-* |
✅ Supported today | Headless kimi --print --output-format stream-json with adapter-owned HOME and MCP wrapper. Best for large-context / architecture work and Kimi native skills/swarm. v1 has no Codex App Server or live turn/steer, no CLI --output-schema, and Kimi MCP tools are addressed by bare names. |
Mixed-team example
codex-implementer # Codex App Server executor
gemini-reviewer # Gemini second-opinion reviewer
kimi-architect # Kimi large-context architecture reviewer
claude-planner # Native Claude lead/planner
Coming next
| Coming next |
|---|
| ⏳ GLM adapter |
| ⏳ DeepSeek adapter |
| ⏳ Generic CLI adapter template |
Codex, Gemini, and Kimi are shipping. Everything in "coming next" is on the same architectural surface — each new model is a new adapter binary + one line in the spawn shim's routing table. See docs/roadmap.md.
Requirements
- Python 3.12+
- Node 18+ (for the npm installer; not required at runtime)
- OpenAI Codex CLI 0.120+ on PATH for
codex-*teammates - Gemini CLI on PATH for
gemini-*teammates - Kimi CLI on PATH for
kimi-*teammates (uv tool install --python 3.13 kimi-clior upstream installer +kimi login) - Claude Code 2.1+ with Agent Teams mode
- Terminal multiplexer on PATH (tmux or psmux) — see configuration.md
Docs
- Install — how the installer wires Claude Code, alternative install methods, headless launches
- Architecture — how the adapter integrates with Claude Code's team protocol
- Roadmap — supported today vs coming next, contribution pointers
- Configuration — CLI flags, env vars, advanced modes
- Releasing — maintainer-facing tag-triggered publish flow
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file claude_anyteam-0.7.8.tar.gz.
File metadata
- Download URL: claude_anyteam-0.7.8.tar.gz
- Upload date:
- Size: 12.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0c31d3128049f8cc40aaec45b2a5eb2be8e9b2849a8f1a04c6467fccad5bd99c
|
|
| MD5 |
b6f122ad5eb88fe9a04ee994666eef64
|
|
| BLAKE2b-256 |
86dee5977a1a5773e11b0e81f16323dbb529dc9d80ef849d16c4d46a1c707186
|
File details
Details for the file claude_anyteam-0.7.8-py3-none-any.whl.
File metadata
- Download URL: claude_anyteam-0.7.8-py3-none-any.whl
- Upload date:
- Size: 188.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7b0767cb5eb61aca1fd652eb17640a886cc442095c97b69a41821cd8e021db54
|
|
| MD5 |
67d1acecbf1bcb4c1ba4c757c80a0da4
|
|
| BLAKE2b-256 |
bab532ed6571460f7b8d65c29e408eb11f1b62fe58a53c1abe9a5c7fee7e87d2
|