agestra
v4.15.0
Published
Multi-host MCP orchestration for Claude Code, Codex CLI, Gemini CLI, and local models
Maintainers
Readme
Agestra
面向 Claude Code、Codex CLI、Gemini CLI 和本地模型的多宿主 MCP 编排工具。
Agestra 用来让多个 AI 从不同角度审视同一个问题,并把结果整理成证据清晰的结论。它适合代码审查、QA、安全检查、设计讨论、想法探索和基于证据的共识。
快速开始
先在你已经使用的宿主里安装 Agestra。
| 宿主 | 安装 |
|------|------|
| Claude Code | 先执行 /plugin marketplace add mua-vtuber/Agestra,再执行 /plugin install agestra@agestra |
| Codex CLI | 先执行 npm install -g agestra,再执行 agestra-install codex --assets --scope user |
| Gemini CLI | 先执行 npm install -g agestra,再执行 agestra-install gemini --assets --scope user |
安装后,打开项目并发起 Agestra 工作流。
- Claude Code:
/agestra review,/agestra qa,/agestra security,/agestra design,/agestra idea - Gemini CLI:
/agestra:review,/agestra:qa,/agestra:security,/agestra:design,/agestra:idea - Codex CLI: 像
Use Agestra with Gemini and Codex to review this branch.这样明确提到 Agestra 或多个 AI
第一次运行时,它可能会询问你要启用哪些 provider。只有一个 provider 也能完成设置和宿主自有流程,但 Multi-AI 比较在两个以上 provider 时效果最好。
用它做什么
review: 比较多个 AI 对代码质量、回归风险、UX 和整理点的看法qa: 按设计文档或计划验证实现,并收集 PASS/FAIL 证据security: 专门做安全视角的检查design: 在写代码前讨论结构和取舍idea: 探索改进方向、备选方案和相似工具
运行时会发生什么
- Agestra 检查设置和可用 provider。
- 它把请求整理成目标和范围明确的工作流。
- 如果需要调查,宿主先收集并整理证据。
- 被选中的 provider 只讨论或审查剩下的未解决问题。
- Agestra 返回一份包含结论、分歧和证据的结果。
普通的 review 或 QA 请求不会自动变成 Agestra 工作流。只有当你使用 /agestra ...,或者明确要求多 AI / provider-backed 的 review、QA、安全、设计或 idea 工作时,Agestra 才会启动。
代码修改应优先由当前宿主直接完成。Agestra 最适合在修改之后审查结果、按计划验证、比较多个 provider 的意见,并记录证据。
在这个仓库里使用
如果你 clone 了这个仓库,想测试当前 checkout:
npm install
npm run bundle然后按宿主执行安装:
npm run install:claude
npm run install:codex
npm run install:gemini这些命令会注册当前 checkout 并安装 helper assets,不会把 npm 包装成全局安装。
如果你想让当前 checkout 像真正的全局包一样工作:
npm run bundle
npm install -g .
npm run install:codex:globalGemini 使用 npm run install:gemini:global。
进一步文档
- commands/: 工作流规范
开发
npm run build
npm test
npm run bundle
npm run lint卸载
Claude Code:
/plugin uninstall agestra@agestraCodex CLI:
npm run uninstall:codex
npm run uninstall:codex:assetsGemini CLI:
npm run uninstall:gemini
npm run uninstall:gemini:assets如果还想删除生成的项目数据,请手动删除 .agestra/。
