Codex Teams

codex团队

一个CLI，负责协调以下团队 Codex CLI 代理人。描述你想要构建、研究或计划什么——codex团队组建了一个lead+员工团队，他们实时沟通、分享发现并交付结果。

______________________________________________________________________

安装

npm install -g codex-teams

然后为你的AI编码工具安装技能：

codex-teams setup

先决条件

• Codex CLI 已安装并打开 PATH (npm install -g @openai/codex)
• Node.js 18+

______________________________________________________________________

快速开始

cd your-project

# Launch a mission — blocks until complete, prints JSON result
codex-teams launch \
  --objective "Add JWT auth with login/register endpoints, middleware, and tests" \
  --lead "Tech Lead" \
  --worker "Backend Engineer" \
  --worker "Test Engineer" \
  --verify "npm test"

就是这样。领导计划，工人们并行执行，他们互相交谈， npm test 自动运行——你会得到JSON和他们所做的一切。

______________________________________________________________________

为什么？

单个AI编码代理有一个上下文窗口。当任务跨越多个层（API、前端、测试、配置）时，它必须不断地切换上下文，忽略细节。codex团队通过为每个代理提供专注于其范围的上下文窗口来解决这个问题。他们通过群聊、DM和共享工件进行沟通，就像一个真正的工程团队一样进行协调。

• 更多的背景，而不仅仅是更多的速度。 每个代理都拥有其作用域的完整上下文。团队共同看到的代码库比一个代理所能看到的要多得多。
• 特工们互相帮助。 后端开发人员共享API合约；前端开发人员读取它并构建以匹配。员工们互相提问，标记集成问题，并在过程中分享发现。
• 内置验证功能。 shell命令（如 npm test)完成后运行。如果失败，主管会分配修复程序，工作人员重试，然后重新运行。
• 你发射并离开。 准备好后检查结果。

______________________________________________________________________

命令

launch --执行任务

codex-teams launch \
  --objective "..." \
  --lead "Tech Lead" \
  --worker "Backend Engineer" \
  --worker "Frontend Engineer" \
  --verify "npm test"

直到完成。进度流到stderr，JSON结果到stdout。退出代码0=成功。

status --检查任务

codex-teams status                  # List all active missions
codex-teams status       # Check a specific mission

steer --任务中期重定向

codex-teams steer  --directive "Fix the auth bug first"

setup --安装AI工具的技能

codex-teams setup           # Auto-detect and install for all found tools
codex-teams setup --claude   # Claude Code only
codex-teams setup --codex    # Codex CLI only
codex-teams setup --all      # Install for everything

help --使用指南

codex-teams help --llm      # Full guide for LLM consumption

______________________________________________________________________

示例

运送功能

codex-teams launch \
  --objective "Add user profile editing: PUT /api/users/:id endpoint accepting
{name, bio, avatarUrl} at src/api/users.ts, React form at src/components/ProfileForm.tsx
using existing Form primitives from src/components/ui/, and integration tests.
Follow the pattern in src/api/posts.ts for the endpoint." \
  --lead "Tech Lead" \
  --worker "Backend Engineer" \
  --worker "Frontend Engineer" \
  --verify "npm test"

审计代码库

codex-teams launch \
  --objective "Audit every API endpoint in src/api/ for: (1) missing input validation,
(2) SQL injection vectors, (3) missing auth checks, (4) information leakage in error
responses. Document each finding with file, line, severity, and fix recommendation.
Output as a structured shared artifact." \
  --lead "Security Lead" \
  --worker "API Auditor" \
  --worker "Auth Auditor"

计划迁移

codex-teams launch \
  --objective "Map every place user IDs appear across src/api/, src/services/,
src/db/, and src/client/. Document the coupling surface, data flow, and hardcoded
assumptions about ID format. Deliver a migration plan as a shared artifact:
what changes where, in what order, what breaks. Don't change any code." \
  --lead "Lead Architect" \
  --worker "API Mapper" \
  --worker "DB Mapper" \
  --worker "Frontend Mapper"

自信地重构

codex-teams launch \
  --objective "Migrate all 12 class components in src/components/ to functional
components with hooks. Each must: (1) preserve identical props interface,
(2) convert lifecycle methods to useEffect, (3) convert this.state to useState,
(4) pass existing tests unchanged. Do NOT modify test files." \
  --lead "Migration Lead" \
  --worker "Component Dev A" \
  --worker "Component Dev B" \
  --verify "npm run typecheck && npm test"

提示： 目标越具体，结果越好。包括文件路径、验收标准、约束以及“完成”的样子。

______________________________________________________________________

高级： --team-json

要完全控制每个代理的配置：

codex-teams launch \
  --objective "..." \
  --team-json '[
    {"role": "Tech Lead", "isLead": true, "reasoningEffort": "xhigh"},
    {"role": "Backend", "specialization": "API design and database queries"},
    {"role": "Frontend", "specialization": "React components", "fastMode": true},
    {"role": "Tests", "specialization": "Integration testing"}
  ]'

______________________________________________________________________

团队规模和成本

经验法则：每个工作的不同部分有一个工作人员。如果任务有三个方面——API、前端、测试——则生成三个工作人员。如果任务有六个独立的区域需要审核，则生成六个worker。如果工作足够大，每个方面本身都是一个多部分的项目，那么可以考虑多个团队——每个主要领域一个团队，每个团队都有自己的负责人和工作人员。

每个代理都是进行LLM API调用的完整Codex CLI会话。更多的代理意味着更多的成本和更高的推理水平(--reasoning)每个代理人再乘以这个数。使用 --reasoning medium 或 --fast 用于探索性或低风险的工作，以降低成本。默认值为 xhigh 对于领先者和 high 对于工人来说。

______________________________________________________________________

运作原理

codex-teams launch --objective "Add auth with tests" --lead "Lead" --worker "Backend" --worker "Tests" --verify "npm test"

  1. Creates a team: lead + 2 workers
  2. Starts the comms server (localhost HTTP for group chat, DMs, artifacts)
  3. Sends all agents their prompts simultaneously
  4. Lead posts a plan in group chat → workers read it and execute
  5. Workers share discoveries and coordinate via chat
  6. npm test runs → if it fails, lead assigns fixes → workers retry
  7. JSON result printed to stdout

建筑

graph TD
    CLI["codex-teams CLI
(your terminal)"]
    CLI -->|spawns via Codex CLI| Lead["Lead"]
    CLI -->|spawns via Codex CLI| WA["Worker A"]
    CLI -->|spawns via Codex CLI| WB["Worker B"]
    Comms["Comms Server
(localhost HTTP)
group chat · DMs · artifacts"]
    Lead |MCP| Comms
    WA |MCP| Comms
    WB |MCP| Comms

每个代理都作为一个Codex CLI线程运行，具有自己的上下文窗口。通信服务器提供经过身份验证的群聊、直接消息、共享工件和等待消息机制。

通过以下方式支持多个团队 --team-json --你可以定义单独的团队，每个团队都有自己的领导和员工。然而，每个代理都是进行LLM API调用的完整Codex CLI会话，因此成本直接随团队规模而增加。

______________________________________________________________________

使用AI编码工具

之后 codex-teams setup，你的AI助手会自动发现codex团队。安装的技能教会了它：

1. 何时使用codex团队 --识别受益于多个代理的任务
2. 如何从你那里收集上下文 --在启动之前询问目标、范围、限制、团队
3. 如何写好目标 --编写详细的工程票质量提示
4. 如何运行和报告结果 --执行CLI并显示输出

你也可以手动调用它：告诉你的人工智能助手“使用codex团队…”或直接引用该技能。

______________________________________________________________________

配置

______________________________________________________________________

发展

git clone https://github.com/skrabe/codex-teams.git
cd codex-teams
npm install
npm run build          # TypeScript → ./build
npm run bundle         # esbuild → ./dist/index.cjs
npm run dev            # TypeScript watch mode
node --import tsx --test tests/*.test.ts    # Run all tests

______________________________________________________________________

卸载

npm uninstall -g codex-teams

要删除已安装的技能，请执行以下操作：

rm -rf ~/.claude/skills/codex-teams
rm -rf ~/.codex/skills/codex-teams
rm -rf ~/.factory/skills/codex-teams
rm -rf ~/.config/opencode/skills/codex-teams
rm -rf ~/.agents/skills/codex-teams

______________________________________________________________________

许可证

麻省理工学院