@arbiterforge/ca-pi

Claude Code, Codex CLI,和Pi 的 AI 编码代理的开源治理和硬门.

代码“仲裁者”是用于测试、审查、安全检查、决定、, 和持久的项目背景。 你决定 代码“仲裁人”执行.

开始学习   • 妇女   安装   • 妇女   浏览引用

_{在全球安装。 它一直处于休眠状态,直到一个仓库明确选择进入.}

代理编码, 有记录

代码仲裁是给团队和电力用户的,他们让编码代理做相应的工作,需要更多的 而不是“模型说它过去了”。 每个请求都进入一个命名道. 车道定义了它的证据 必须制作、它必须派出的审查人员以及制止这种情况的条件.

此寄存器包含四个兄弟姐妹插件 :

• ca 克劳德代码, ca-codex 用于Codex CLI,以及 ca-pi 因为皮是三个治理主机.
• ca-sandbox 是孤立的本地代码空间基础设施插件.

三个治理主机来自一个共享的地表并使用一个登录 .codearbiter/ 项目存储。 一个寄存器可以在主机之间移动而不失去它的规格,计划, 发展成果评估、任务、决定或审计历史.

代码

• 在要求的失败测试存在之前写入特性代码;
• 在一个红色的套房里或在门外行刑;
• 决 议 a [CONFIRM-NN] 通过猜想提问;
• 悄悄地调和规则、文件与代码之间的冲突;或
• 直接推到默认分支,或者在没有用户的情况下合并.

大门对工作的规模。 散文编辑取道小道. 安全敏感特征 采用全谱,先试,再审,再审和公关路径.

密码路径被现场验证 代码CLI 0.144.1 信任的会话启动注入和 a 真实 [H-03] PreTooLus 块. 日期 Claude 代码 + 代码证据 将不断核实的包装与需要模型后置转弯的活检分开.

看它抓住什么东西

登陆页包括: 忠实地重放已运去的钩子引用。 。 。 . 它引用真实的 pre-bash.py 警卫,记录源摘要,证明被封锁的命令永远不会 运行,并保留准确的 stderr 和审计效果。 它不假装一个直接的钩子重放 证明主机发现或信任.

操作循环是这样的:

you      /ca:fix the statusline keeps running the old version after an update

arbiter  route to the regression-test-first fix lane
         failing test -> minimal fix -> focused proof -> full verification

you      /ca:commit
arbiter  permission -> branch -> tests -> behavioral proof -> diff review
         selective stage -> commit

you      /ca:pr
arbiter  reviewer fleet challenges the exact diff
         BLOCK findings are resolved before the draft PR can advance

由用户拥有决定权. 存放所保存的证据.

走开

为您已经使用的编码主机选择适配器 。 这个 主机选择器 覆盖 稳定性,命令语法,信任,和平台差异.

先决条件: Python 3 打开 PATH 财务报告和审定财务报表 git config user.email 设置。 ADR 生命周期证明 基特 2.45.0+ 与 --no-lazy-fetch 所有三个治理主机; 无法使用的旗下支持块 具有升级先决条件的核查,绝不是暗中获取回落。 Pi也需要节点.js 22.19+. 如果 Python 缺失, Pi 将安装其最后的包装器,但块块变换调用并指向 /ca-doctorClaude Code 和 Codex 浮出一个翻译面包屑来而不是默默声称 治理是积极的。 这个 兼容矩阵 定义支持的本地 Git/ runtime 和链接- worktree 边界; 混合 Windows Git 和 WSL Git 不支持超过一个共享仓库.

克劳德代码

/plugin marketplace add arbiterForge/codeArbiter
/plugin install ca@codearbiter

批准普通插件信任提示, 打开目标寄存器, 并继续 /ca:init。 。 。 .

代码 CLI

公众的GitHub-slug流是 现在可用。 。 。 . 当前适配器版本读取自 plugins/ca-codex/.codex-plugin/plugin.json。 。 。 . 发现的从头到尾的公开安装记录 ca-codex 0.2.4 从释放开始 v2.8.13。 。 。 . 目前包装和共同核心均等情况不断得到核查,而这一历史记录 保留标签而不是被提升为新适配器的证据:

codex plugin marketplace add arbiterForge/codeArbiter --ref ca-codex-marketplace
codex plugin add ca-codex@codearbiter

这个 ca-codex-marketplace 分支是推广的目录。 它的入门针入 不可改变 ca-codex-dist-v<version> Git 标签, 保存精确的合格发布 档案,包括原生文物发动机; main 继续发展 源树, 而不是被推广的二进制的替代品 分发。 (助读) @arbiterforge/ca-codex npm频道已经计划了,但推迟了, ADR-0040 (英语)

若为 codearbiter 以前没有登记 --ref ca-codex-marketplace, (中文(简体) ), marketplace upgrade 保留默认分支 注册,而不将其迁移到促进的二进制通道。 删除和 重新添加市场, 然后重新安装插件 :

codex plugin remove ca-codex@codearbiter
codex plugin marketplace remove codearbiter
codex plugin marketplace add arbiterForge/codeArbiter --ref ca-codex-marketplace
codex plugin add ca-codex@codearbiter

打开 /hooks,审查和信任 ca-codex 处理者,然后开始新的任务。 运行 $ca-init 财务报告和审定财务报表 $ca-doctor。 。 。 .

用于针对未公布的退出开发 :

git clone https://github.com/arbiterForge/codeArbiter
cd codeArbiter
codex plugin marketplace add .
codex plugin add ca-codex@codearbiter

Pi

[注] ca-pi 是一个特性 Forge preview。现在可供实际使用,欢迎您使用 安装它,在仓库里使用它,并报告你找到什么。 其自动和托管的推广 矩阵是绿色的;在代码仲裁人索赔之前,仍然需要更广泛的现实世界证据 100%验证或稳定状态.

最快安装的是 npm 频道 : pi install npm:@arbiterforge/ca-pi (ADR-0029) (中文(简体) ). 给 可复制被绑定安装, 列出独立版本的标签, 选择一个精确的结果, 然后 检查已安装的软件包, 给予项目信任, 并开始新的会话 :

git ls-remote --tags --refs https://github.com/arbiterForge/codeArbiter.git "ca-pi-v*"
pi install git:github.com/arbiterForge/codeArbiter@ca-pi-v<version>
pi list
pi config

替换 <version> 使用所选标签中的数字后缀,同时保留完整 ca-pi-v... 标记在安装源。 Git-tag装置没有本地的文物发动机,所以 它是一个无法输入 HTML 规格和计划的部分安装; 使用 npm 通道用于 那个.

Pi 1.1.0是此放行所支持的主机. 生成的别名使用 /ca-*· ; /skill:ca-* 是主机的倒置。 每个 ca-pi-v* 标记也作为 npm 发布 npm:@arbiterforge/ca-pi 有出处(ADR-0029);被钉住的Git标签仍然是可复制的 安装。 这个 Pi 运行本 覆盖孤立的安装、信任、核查、, 共享状态连续性, 和未安装 .

保护第一个寄存器

第一次运行时使用可支配的 Git 仓库 。 添加至少一个有意义的源文件, 那么 引用下列主机内设表格:

init 创建 .codearbiter/ 并引导一个已存在的代码库到 create-context 或绿地 项目改为 decompose。 。 。 . doctor 必须报告健康的口译、当前有效载荷和H-03 在你把寄存器当成受管者之前 进行实弹探测.

跟着完成 第一仓库走过 用于预期产出、证明和回收.

在使用您自己的仓库前练习

仲裁员学院 是一个可选的实践课程 代码仲裁。 它开始于一个个人的叉子 学院的仓库, 所以你可以做出真正的承诺, 检查规范的证据,从失败的尝试中取回,而不使你自己的项目面临风险.

学院网站是课表. 每个已公布的教训都指明一个动作是否属于 在浏览器中,本地终端,活化绳,或与代理,然后提供可复制命令, 检查证据 安全找回路径 你想从那里开始 在保护生产存储器之前先学习工作流程.

文档是操作手册

该网站被设计为从第一次接触到源头支持的操作的连续路径:

命令、技能、代理和钩口参考页由每个站点的已发送源生成 建设。 手写指南教授工作流程;生成的页面定义了准确的当前表面.

治理如何运作

flowchart LR
    I["host-native command"] --> R["owning skill"]
    R --> A["author or operator action"]
    A --> V["tests + focused proof"]
    V --> F["matched reviewer fleet"]
    F --> G{"gate clear?"}
    G -->|no| X["named finding or user decision"]
    X --> A
    G -->|yes| P["selective commit + draft PR"]

激活是明确的,每个存储处都有。 Claude 代码和代码检查 .codearbiter/CONTEXT.md 在会话开始。 Pi 通过它检查相同的文件 session_start 扩展事件,同时也需要肯定的项目信任。 无 arbiter: enabled,全球 安装为休眠:没有寄存器人物a,没有寄存器门,也没有治理行.

该项目记录了在代码旁边的生活:

.codearbiter/
├── CONTEXT.md             activation, vocabulary, maturity, current objective
├── context/               native HTML knowledge (new default)
├── work/                  portable project ID and native work items (new default)
├── tech-stack.md          legacy Markdown knowledge
├── coding-standards.md    legacy Markdown knowledge
├── security-controls.md   security policy; scope blocks persist after conversion
├── open-tasks.md          legacy work board (existing or explicit Markdown)
├── open-questions.md      unresolved [CONFIRM-NN] decisions
├── decisions/             numbered ADRs
├── specs/ and plans/      approved intent and execution
├── sprint-log.md          SMARTS-scored autonomous decisions
├── checkpoints/           periodic reviewer sweeps
├── audits/ and reports/   assembled evidence
└── overrides.log          append-only sanctioned bypass record

这个 .codearbiter 目录参考 解释是谁创造、阅读和更新了所有文物,再加上其回收规则.

硬门

• 之前没有特征代码 tdd 第一阶段完成.
• 外面没有犯罪 commit-gate永远不要用红色套房.
• 没有 [CONFIRM-NN] 通过猜测解决.
• 不默默地调和统治冲突;途径 /ca:conflict。 。 。 .
• 没有原始的秘密存储在寄存器、日志、图像或提示中.
• 没有直接写入默认分支, 也没有强制推出 .
• 外面没有自动识别码 /ca:adr,有明确的用户属性.
• 每个 /ca:override, (中文(简体) ), mode --dangerous编号 :mode --ops 进入/出入境,冲刺自动决定是耐用和可归属的.
• H-18 激活保护没有会话内覆盖路径;禁用寄存器需要 外部编辑和明确的审计记录.

安全和审计的轨迹正确性高于数据完整性、可维护性、性能和 速度。 速度。 一种非明显的取舍,举出其作出的程度.

SMARTS:有限度的自治,明确推理

SMARTS评价可扩展性、可维护性、可用性、可信赖性、可检验性和安全性. 每个选项都得到具体的裁决和证据,然后是 strong, (中文(简体) ), moderate,或 tied 建议。 用户仍决定.

/ca:sprint 使用相同的镜片来进行非硬性决定,并将每个呼叫写给 .codearbiter/sprint-log.md 带着自信的旗帜 安全边界 不可逆转的行动, 闸口绕行,合并,未解决的问题仍为真站. 见 示意图 财务报告和审定财务报表 自动短跑。 。 。 .

核心车道

先选择工作流程 。 舟行道保持日常工作紧凑;先进作业和 完整的参考文献中仍然有兼容性路线.

完整命令参考 包含 高级操作、兼容路线、内部协议、折旧指导以及主机 可用性。 生成的主机目录仍可检查于 plugins/ca/COMMANDS.md, (中文(简体) ), plugins/ca-codex/COMMANDS.md,以及 plugins/ca-pi/COMMANDS.md克劳德代码包括 statusline 财务报告和审定财务报表 prune; Codex 故意省略两者. Pi 省略 statusline 并使用本地紧接器通过 联合国 prune 路线.

信任和主机边界

屏蔽执行核心是本地的和Python-stdlib的. 它读取寄存器文件和本地文件 纪州. 它不会将寄存器内容发送到代码仲裁人账户; 没有主机 代码 仲裁控制平面.

有两个背景内容与阻止评价是分开的:

• 会话启动可能运行一个脱开的,只读 git fetch 相对于仓库配置的远程 报告卫生状况.
• 每日一次的故障-静态更新检查可读取公众 GitHub Releases API. 没有寄出仓库 内容,从不应用更新.

可选 /ca:sprint --farm 预览是一个独特的选择入网功能。 它发出字节封口, 您配置的与 OpenAI 兼容的端点的密钥已编辑的任务上下文, 并且没有此设置是惰性的 旗帜和提供者的密钥.

见 执法与安全 编辑 钩子参考 确切事件,读取:, 写作 块和网络合同.

皮业务合同

ca-pi 在交互式父会话中安装丰富的页脚。 治理行只在 启用并肯定信任寄存器;省略了速率窗口遥测,而不是 捏造的 执行模式在调节突变和外在副作用前询问. 计划模式是 仅读取,但不包括目前的犬类分类、计划和计划分类账.

背景任务是限定且只设会话的,从Pi会话条目中永远不会恢复. 未经核实的清理 显示经理不健康, 阻断以后的发射 /ca-doctor。 。 。 . 页脚、权限、计划和背景表面仅是父交互的,永远不会重现 坚固的孩子.

人类可读的生成目录是 plugins/ca-pi/SKILLS.md冷清时,平台 合并报告 missing_prerequisite 并指示操作员 npm --prefix plugins/ca-pi/tools ci --ignore-scripts;它从不安装对 验证路径.

特性福尔格

预览功能是构建、测试和运输的,但它们仍然选择使用和休眠,直到 现实世界的证据获得稳定的地位。 预览标签不会削弱硬门,也不会隐藏 支出或信任要求.

源头支持 活福吉目录 指定每个选入、关闭开关、依赖、信任边界和升级信号.

农场的预览用一个检查 farm.js 支持的主机之间的后端 。 嵌入的 Pi- 内置 农场工人是未来的高峰,而不是航运依赖或第二引擎. ca-pi 以 被钉住的 Git 标签加 CI 发布 npm:@arbiterforge/ca-pi 软件包(ADR-0029).

运算符细节

Claude 代码状态线

运行 /ca:statusline 以安装可选符号意识状态线.

文件夹、 Git 状态、 速率限制、 符号使用、 成本、 上下文头室、 模型、 工作量和会话年龄 在全球制造。 治理行仅在启用的寄存器中激活. 运行 /ca:statusline uninstall 以恢复上一条状态线,或删除 当不存在先前的行时,仲裁人设置。 运行 /ca:statusline install 再次刷新已安装的路径并保存备份;它不会卸载.

/plugin marketplace update codearbiter

仓库地图

.claude-plugin/marketplace.json     Claude marketplace
.agents/plugins/marketplace.json    Codex marketplace
core/                               canonical shared policy and generated surface
plugins/ca/                         Claude Code governance host
plugins/ca-codex/                   Codex governance host
plugins/ca-pi/                      Pi governance host (Feature Forge preview)
plugins/ca-sandbox/                 isolated local-Codespace plugin
site/                               Astro/Starlight documentation product
docs/                               architecture, parity runbooks, reports, and media
.codearbiter/                       this repository's own governed project state

plugins/ca/ 包括总指挥、公共指挥、守门员、特派员, 钩子和农具 这个 结构文件, (中文(简体) ), 平等分类账, (中文(简体) ), 财务报告和审定财务报表 全钩合同 是维护者的切入点.

pi install git:github.com/arbiterForge/codeArbiter@ec64809c1b6c32f69e3d9787ab205f7bbd563d50
pi list
pi config

项目历史

代码Arbiter v2 是早先销售商的地基重建 .agents/ 框架作为本土, 多主机插件系统. 完整记录在 CHANGELOG.md 编辑 站点更改日志v1 执行 在早期存储器历史中仍然可用.

许可证和捐款

代码 GNU 阿费罗通用公共许可证 v3.0 (AGPLv3) (英语). 你可以使用、学习、修改和 根据这些条件重新分配。 AGPLv3 第13节也适用于修改后的版本运行为 网络服务.

AGPLv3的过渡从v 2. 6.0 向前适用. 提前释放时仍持有许可证 运出.

开源. 代码AGPLv3下可免费提供开源使用.

商业许可证. SUaDtL保留版权并保留提供项目的权利 根据单独的专有条款。 目前尚未提供商业许可证。 问询 如果AGPLv3不符合使用情况,可通过GitHub进行.

捐款. 目前没有签订任何捐助者许可证协定。 见 CLA.md 用于其状态和维护者处理。 未来的协议 要求法律审查和单独的明确同意; 维护者不得推断 从已退休的模板中获取额外的专利再许可权.