用途
ORCH 的核心定位是"一条 CLI 编排所有工具"。它解决的是：当你购买并使用了 Claude、Codex、Cursor 等 AI 工具后，反而要把大量时间花在多个终端之间复制上下文、手动排解文件冲突、跟踪各智能体进度上的问题。ORCH 让多个 AI 智能体围绕同一个项目目标并行工作，用户只需设定目标，无需逐个照看。其宣传的场景是：晚上 10 点设下目标，五个智能体分解、实现、测试并审查，醒来时收到拉取请求。
主要能力
- 多智能体并行协调：可同时协调 Claude、Codex、Pi、Cursor 以及任何 CLI 工具。
- 组织化分工：CTO 智能体负责战略分解，将高层目标拆成具体任务并分配给相应部门；工程部门并行执行；QA 部门自动验证，测试失败可带反馈退回工程；代码审查作为强制质量门。
- 部门间通信：支持直接消息、团队广播和共享上下文存储，例如后端完成后通知 QA 开始测试，无需人工路由。
- 隔离与安全：每个智能体在独立的 git worktree（独立分支）中工作，主分支在明确批准合并前不受影响；状态机包含强制审查步骤；具备范围重叠检测以防止冲突。
- 容错机制：失败任务自动以指数退避重试；停滞任务由僵尸检测终止并重新入队；状态机校验每次状态转换，避免任务丢失。
- Shell 适配器：任何能在终端运行的工具都可作为智能体，如 npm test、python bot.py、Semgrep、curl、CRM 脚本、数据管道等，并获得状态跟踪、重试与协调能力。
- 适配器生态：提供八种适配器——Claude Code、OpenCode（Gemini、DeepSeek、任意 OpenRouter 模型）、Codex、Pi、Cursor、Grok、Antigravity 和 Shell。使用用户自己的 API 密钥与工具。
使用方式
安装：一条 npm install 命令即可完成（资料未给出完整安装命令原文，仅说明为一次 npm install）。安装后 ORCH 自动初始化并打开 TUI 仪表盘，可在其中添加智能体、设定目标并运行。
Claude Code 集成：安装后 Claude Code 中会自动提供 /orch 技能，输入 /orch 并用自然语言描述需求，Claude 会将其转换为相应的 orch 命令（创建智能体、任务、目标并运行编排），无需记忆 CLI 参数。
也可一键部署预置团队（如 content-agency、data-lab、sales-machine 等模板）。
CLI 别名：orchestry、orch、ao。
无头守护进程与 CI/CD：通过 orch serve 在服务器上 24/7 运行，无 TUI，输出结构化 JSON 日志，可接入 Datadog、Grafana Loki 或 jq。支持 watch 模式（默认，tick 循环无限运行，可从另一个终端用 orch task add 添加任务）和 once 模式（--once，处理完所有现有 todo 任务后退出，不进行自主任务播种）。具备锁保护（每个项目仅一个编排器，复用 .orchestry/orchestry.lock，第二个 orch serve 会报错退出）、优雅关闭（SIGINT/SIGTERM 后停止接收新任务、等待运行中的智能体、保存状态、释放锁）、堆内存监控（每次 tick 记录 heap_mb）和空闲节流（约每 6 次空闲 tick 记录一次）。可用 pm2 或 systemd 部署。
作为库使用：ORCH 是引擎优先、CLI 其次，核心对 CLI/TUI 层零依赖，可 import @oxgeneral/orch 构建自己的界面。
适用场景
- 独立开发者或小团队希望以"一人加若干智能体"的方式完成原本需要整个团队的工作。
- 需要让多个 AI 智能体在同一代码库上并行开发而不互相覆盖。
- 需要自动化流程而非仅编码，例如编辑、销售、分析、安全、DevOps 等，只要能在终端运行即可。
- 希望在服务器上长期无人值守运行编排，并接入日志聚合系统。
限制与资源占用
- 系统要求：最少 1-2 个智能体，推荐完整部门 4-6 个智能体；不需要数据库、云服务、Docker 或 GPU（LLM 通过 API 调用，不在本地运行）。
- 内存占用：ORCH 自身约 120 MB，外加每个并发智能体约 300 MB（每个是独立的 Node.js/Python 运行时）。公式为 120 MB + N × ~300 MB：2 个智能体约 0.7 GB，4 个约 1.3 GB，6 个约 2 GB。
- 状态存储：全部在 .orchestry/ 目录中，使用纯 YAML、JSON、JSONL 文件，无需注册账号，数据不离开本机。
- 许可与费用：开源 MIT 许可；只支付已使用的 AI API（Claude、Codex 等）费用，TUI 实时显示每个智能体每次运行的 token 成本（示例：5 个智能体、6 个任务约 4.20 美元）。
暂未提供的信息
资料未给出完整的安装命令原文、各 CLI 子命令的详细参数表、预置团队模板的完整清单与内容、具体 API 定价，以及可运行的演示环境等。
