commitarium

Commitarium 提供了一个本地优先的环境，用于协调编码代理共同规划、实施和审查软件。该系统基于一个协调器构建，该协调器管理项目、功能、工作流程转换和代理会话，并将操作状态存储在 SQLite 中。它支持用于测试的确定性模拟模式，以及使用真实 AI 代理（Codex 或 Claude）的可选模式。 在真实代理模式下，协调器连接到选定的主导代理和审查代理的持久对话。工作流程包括目标澄清、规划、实施和审查周期。该系统与 Forgejo（一个自托管的 Git 仓库）集成，作为计划、审查和拉取请求的权威来源。每个代理都使用自己的受限 Forgejo 身份运行，确保提交和结构化 PR 工作的审计跟踪。协调器在推进工作流程之前，会验证代理的输出，例如提交哈希和 PR 头。 该架构通常通过 Docker Compose 运行，包含协调器、Forgejo 和工作代理的服务。它支持独立的提供商配置文件，用于 Codex 和 Claude，允许独立的身份验证和配置。该系统包括重启恢复功能，允许在协调器重启后恢复活动会话。它还提供项目导入功能，允许用户将现有 Git 仓库与工作空间关联。该设计强调用户控制，提供了自动或手动批准合并和工作流程步骤的选项。