Skip to main content

Bring Codex, Gemini, and Kimi CLI powered teammates into Claude Code with multi-backend routing.

Project description

claude-anyteam

Native Claude Code teammates, any LLM.

Codex, Gemini, and Kimi today. GLM, DeepSeek next — on the same team-native architecture.

License Python Node Backends Tests

Quickstart · Architecture · Roadmap

claude-anyteam spawning a mixed Codex + Claude team

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.

claude-anyteam architecture

Quickstart

npx --yes claude-anyteam

That's the entire install. The installer:

  • Detects python3 and installs uv if missing (non-interactive, no shell profile edits)
  • Installs the claude-anyteam Python tool via uv 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 turn/steer App Server call. Codex reshapes the in-flight turn instead of discarding it. v7.1.

Cross-task memory

Each new task forks from the previous task's Codex thread via thread/fork. The teammate carries its own conversational context forward across the team's task list. v7.3.

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-cli or 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

claude_anyteam-0.7.10.tar.gz (12.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

claude_anyteam-0.7.10-py3-none-any.whl (188.8 kB view details)

Uploaded Python 3

File details

Details for the file claude_anyteam-0.7.10.tar.gz.

File metadata

  • Download URL: claude_anyteam-0.7.10.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

Hashes for claude_anyteam-0.7.10.tar.gz
Algorithm Hash digest
SHA256 054b1a157d727e46ffb15efb8070dc1e98494b81d138682180cefce4994080a2
MD5 8bb374f3cb31e712990e861772a544c2
BLAKE2b-256 f4afadebf038c4dfe73bc236d23ea59b4bbb25ce84db89b17463c6aa159d4fe2

See more details on using hashes here.

File details

Details for the file claude_anyteam-0.7.10-py3-none-any.whl.

File metadata

  • Download URL: claude_anyteam-0.7.10-py3-none-any.whl
  • Upload date:
  • Size: 188.8 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

Hashes for claude_anyteam-0.7.10-py3-none-any.whl
Algorithm Hash digest
SHA256 f294525c1d2b03438da544395c9e7521edb43bf463fa9b62ad780b30fb412820
MD5 7d5d2f3ebea40636fbc8fb5b04a9c93a
BLAKE2b-256 f28b15f929d57f64a94dcdcd9c65d9091210d85d358aeb90640e78f6890cb4da

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page