agent-worker 用于创建和管理 AI 智能体会话，支持 SDK、Claude CLI、Codex、Cursor 等多种后端，并提供多智能体工作流协作。它有两种模式：Agent 模式通过命令行运行单个智能体，Workflow 模式用 YAML 编排多个智能体；两者共享上下文系统，智能体通过频道（@提及）和文档（共享工作区）通信，所有内容按 workflow:tag 命名空间隔离。
Agent 模式常用命令：agent-worker new -m anthropic/claude-sonnet-4-5 创建智能体；agent-worker send a0 "..." 发送消息；agent-worker peek 查看对话；agent-worker stop a0 停止。后端通过 -b 指定 sdk、claude、cursor、codex 或 mock，其中 mock 无需 API 可测试。还支持周期性唤醒调度（如 --wakeup 30s）、工具管理（仅 SDK 后端，--tool 导入工具文件）、审批工作流（pending/approve/deny）以及 stats、export、clear 等单智能体操作。
Workflow 模式通过 YAML 定义 agents、context、setup 和 kickoff，用 agent-worker run review.yaml 运行，可用 --tag 隔离多个实例。支持变量插值（${{ workflow.name }}、${{ env.VAR }}、${{ task_output }}）、顺序交接、并行执行和基于文档的协作，并提供频道、文档、提案与投票等协作工具。
SDK 还可通过 TypeScript 编程调用 AgentWorker，支持 send、sendStream 和状态管理。限制：工具管理仅 SDK 后端支持；部分场景需配置 API Key；具体收费标准、性能数据未提供。