https://github.com/jonathanrosado/claude-anyteam
Native Claude Code teammates, any LLM. Codex today. Gemini, Kimi, GLM, DeepSeek next.
https://github.com/jonathanrosado/claude-anyteam
agent-teams anthropic claude-code codex developer-tools llm openai
Last synced: about 2 months ago
JSON representation
Native Claude Code teammates, any LLM. Codex today. Gemini, Kimi, GLM, DeepSeek next.
- Host: GitHub
- URL: https://github.com/jonathanrosado/claude-anyteam
- Owner: JonathanRosado
- Created: 2026-04-23T04:02:49.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-23T05:19:12.000Z (2 months ago)
- Last Synced: 2026-04-23T05:20:32.703Z (2 months ago)
- Topics: agent-teams, anthropic, claude-code, codex, developer-tools, llm, openai
- Language: Python
- Homepage: https://github.com/JonathanRosado/claude-anyteam
- Size: 2.25 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Roadmap: docs/roadmap.md
Awesome Lists containing this project
README
### Native Claude Code teammates, any LLM.
**Codex, Gemini, and Kimi today.** GLM, DeepSeek next — on the same team-native architecture.
[](LICENSE)
[](pyproject.toml)
[](npm/package.json)
[](#supported-backends)
[](tests)
[**Quickstart**](#quickstart) · [**Architecture**](docs/architecture.md) · [**Roadmap**](docs/roadmap.md)
---
## What it is
Claude Code's [Agent Teams](https://code.claude.com/docs/en/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
```bash
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-`, `gemini-`, or `kimi-`:
```
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|plan` permission bridging and team-lead next-turn steer. See [Gemini adapter limitations](docs/gemini-adapter-limitations.md) for known gaps and trust caveats. |
| 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
```text
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](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/configuration.md#teammate-display-mode)
## Docs
- [Install](docs/install.md) — how the installer wires Claude Code, alternative install methods, headless launches
- [Architecture](docs/architecture.md) — how the adapter integrates with Claude Code's team protocol
- [Roadmap](docs/roadmap.md) — supported today vs coming next, contribution pointers
- [Configuration](docs/configuration.md) — CLI flags, env vars, advanced modes
- [Releasing](docs/releasing.md) — maintainer-facing tag-triggered publish flow
## License
MIT