Citadel 编码代理运行层
让 Claude Code 与 Codex 的多步骤仓库工作可恢复、可验证、可协调。
这个 Agent 能做什么，适合哪些场景？
Citadel 是面向 Claude Code 和 OpenAI Codex 的开源仓库运行层，而不是替代编码代理本身。它以 /do 作为自然语言入口，为请求选择工作流、协调会话、持久化 campaign 或并行 Fleet。项目状态、交接记录、发现与遥测默认保存在仓库本地，支持后续会话恢复工作。它还提供生命周期 hooks、验证结果、操作回执和受约束的 portable operations。安装后，Citadel 在现有 Git 仓库中生成运行时配置与本地状态；可选的跨克隆记忆会写入用户级 SQLite 数据库。
用户执行 /do <request> 后，Citadel 会把请求路由到聚焦 skill、协调会话、campaign 或 Fleet，并在执行期间通过 hooks 应用仓库规则、为重要操作设置审批边界、记录所需检查。它将结果、handoff 和 next action 写入仓库本地状态；/do next 或 /do continue 可据此恢复工作。对于需要稳定契约的任务，citadel operation ... 可添加质量、隐私、工具、时间、模型回退和成本约束，并产出 attempts、intents、evidence 与 receipts。Operation Fork 可在隔离的 Claude Code 与 Codex worktree 中执行同一目标；citadel memory enable 则在 Node.js 22.13+ 上启用用户级 SQLite 跨克隆记忆。
- 使用 Claude Code 的维护者需要在多次会话之间延续重构任务，并通过 /do continue 获取明确的下一步。
- 使用 OpenAI Codex 的团队要在有仓库规则和验证要求的代码库中处理多步骤修改。
- 需要让多名代理或多个分支并行处理工作、同时保留 worktree 隔离和共享发现的工程团队。
- 希望比较 Claude Code 与 Codex 对同一目标执行结果的评估者，可使用 Operation Fork 的隔离分支流程。
- 需要为可重复操作保存权限、检查、停止条件和可验证回执的负责人。
这个 Agent 有哪些优点和局限？
- 同时直接支持 Claude Code 与 OpenAI Codex，并为各自提供安装路径。
- 通过 campaign、handoff、discoveries 和 next action 将工作状态保存下来，适合会中断的仓库任务。
- 以 hooks、验证状态和 receipts 记录操作；缺失证据不会被标记为成功。
- Operation Fork 支持在隔离的 Claude Code 与 Codex worktree 中比较同一目标。
- 需要 Claude Code 或 OpenAI Codex、Node.js 18+ 和 Git 仓库，不能作为独立编码运行时使用。
- Citadel 以代理已有权限运行，不能取代代码审查、分支保护或仓库专属检查。
- 跨克隆记忆需 Node.js 22.13+，并会使用用户级 SQLite 存储。
- 公开的代表性 shakedown 未达到冻结的 20% 能耗门槛；README 明确将该结果标为失败。
如何安装或部署这个 Agent？
前提是已有 Claude Code 或 OpenAI Codex、Node.js 18+ 和 Git 仓库。在目标仓库中让编码代理安装 Citadel，随后按其打印的启用步骤操作并开启新会话，执行 /do setup --express。手动安装时，先运行 git clone https://github.com/SethGammon/Citadel.git ~/Citadel；Codex 运行 node ~/Citadel/scripts/install.js --runtime codex --add-marketplace，Claude Code 运行 node ~/Citadel/scripts/install.js --runtime claude --install --scope local，然后在同一仓库的新会话执行 /do setup --express。
如何使用这个 Agent？
完成 setup 后，直接运行如 /do review README.md、/do generate tests for the changed files 或 /do next。需要显式操作约束时使用 citadel operation ...；需要跨克隆记忆时，在 Node.js 22.13+ 环境运行 citadel memory enable。
这个 Agent 与同类方案有什么区别？
Citadel 不替代 CLAUDE.md 或 AGENTS.md：这些文件描述项目规则，Citadel 提供将规则持续执行的工作流与状态。对于一次性短小修改，现有编码代理可能已足够；Citadel 面向工作流选择、恢复、协调与验证成为主要难点的场景。