@caddis/ cli (中文(简体) )

一个安装、更新和诊断命令 卡迪丝 你使用的每一个编码代理都使用dev拉带.

npx @caddis/cli init      # detect your agents, confirm, install caddis into each
npx @caddis/cli doctor    # what is installed where, and what to do about it

如果使用一个以上的编码代理,则Caddis可以使用一个以上的地方 stale. 这个CLI是单一的正门.

它会做什么

caddis是一个 元安装器它探测到机器上的特工和驱动器 每个人都有自己的 本地安装机制 它永远不会重新执行它们 也不会为你安装代理.

代码和副驾驶 检测和报告从来没有写信。 他们是档案组的, 也就是说,要正确支持它们,就必须合并成你已经拥有的配置——即船舶 这是安全的,不是以前.

缺席是优雅的. 失踪的特工有原因 绝对不会出错 一个代理失败 永远不会阻止其他人.

安装

npx @caddis/cli <command>      # no install
npm i -g @caddis/cli           # then just: caddis <command>

要求数 节点 20.19。 。 。 .

图标

caddis doctor

一个值得知道。 每个代理,caddis版本 每个实际有, 是否匹配什么 这艘CLI飞船 是从哪里读来的版本 以及修复每个缺口的确切命令.

Environment
  ✓ node 22.14.0
  • platform win32 x64
  • @caddis/cli 0.2.0
  ✓ shipped pool 1.3.39
      bundle antigravity-plugin @ 1.3.39
      bundle antigravity-plugin-extras @ 1.3.13

Agents
  ▲ Claude Code — caddis 1.3.38 → 1.3.39 available
      C:\Users\you\AppData\Roaming\npm\claude.CMD
      agent version 2.1.220
      read from `claude plugin list`
      → caddis update --agent claude
  ▲ agy (Antigravity) — caddis 1.3.38 → 1.3.39 available
      ~\.gemini\config\plugins\caddis\plugin.json
      → caddis update --agent agy
  • Codex — detected — not yet supported

Summary
  3 of 4 agents detected · 0 current · 2 stale · 0 not installed

  2 things to fix:
    • Claude Code has caddis 1.3.38, this CLI ships 1.3.39
      caddis update --agent claude
    • agy (Antigravity) has caddis 1.3.38, this CLI ships 1.3.39
      caddis update --agent agy

--strict 当某物需要修复时退出非零( 对于 CI) 。 检测到但没有支持的物剂 信息,而不是失败,永远不要绊倒 --strict。 。 。 . --json 给出机器可读输出.

doctor 还检查是否 @caddis/cli 本身在 npm 后面 (单位:千美元) npm view 查找, 选择进入 doctor 仅 -- status编号 :init编号 :update 默认情况下保持无网络状态,这样他们就不会觉得挂下线了. 这很重要,因为上面的每张逐剂漂移检查 都比起装入的游泳池 这个 安装 —— 一种本身僵化的CLI可以少报告漂移情况,尽管每项比较都是 没错 当落后时,医生补充说:

  ▲ @caddis/cli 0.2.3 → 0.2.4 available
      npm i -g @caddis/cli@latest

并算作一个 --strict- 抽水问题,和代理漏洞一样.

caddis status

与可观表相同的事实. 光着身子跑 caddis 这样做.

  caddis  cli 0.2.0  ·  pool 1.3.39  ·  extras 1.3.13

  AGENT              DETECTED  CADDIS  EXTRAS  STATE
  ─────────────────  ────────  ──────  ──────  ────────────────
  Claude Code        yes       1.3.38  —       update available
  agy (Antigravity)  yes       1.3.38  1.3.13  update available
  Codex              yes       —       —       planned
  GitHub Copilot     no        —       —       —

  2 agent(s) behind — run caddis update (or caddis doctor for detail)

caddis update

将每个检测到的、 支持的代理带入此 CLI 中的 Caddis 版本, 通过该版本 特工的内在机制。 已存在的代理被跳过( E)--force 重新驾驶它们.

特务. caddis-extras 是可选的长尾技能库。 没错 从未安装 默认 - 它很大而且总是满载的,但是 --extras 加上它,一旦安装, 平地 update 保持它流畅 以免它被遗忘的旗帜所腐烂 它的版本独立于 核心池,这样 status 财务报告和审定财务报表 doctor 在单独的一栏中报告漂移情况.

caddis init --extras       # core + extras
caddis update --extras     # add extras to an existing install

caddis init

初行所行相会. 检测,显示它要运行的确切内容,询问,然后安装. --yes 跳过 请求CI.

caddis hub

一个本地网页(只有127.0.0.1页),其中包含您的重置,公关,计划和直播会话. caddis hub start 开始于背景; caddis hub stop 别闹了.

更新本身. 运行中的中枢检查 npm 一个新的 @caddis/cli 开始后60 s,然后每30分钟一次. 当发布较新的版本时,中心会安装它(npm i -g @caddis/cli@<version>),检查已安装的版本,并在同一端口重新启动. 打开标签显示"caddis中枢更新到X,再装入"并重新装入. 手册 npm i -g @caddis/cli 并在一分钟内重新启动中枢。 一个失败的安装使旧的枢机运行,并在一个小时后再次尝试. 只有运行于全局 npm 安装的中枢才会安装更新: 运行于 dev 退出或 npx 只有日志"更新可用". 只检查和日志, 设置 "auto_update": false 内 ~/.caddis/hub/config.json。每一步 ~/.caddis/hub/hub.log。 。 。 .

从登录开始. caddis hub autostart enable 在每个登录后启动中枢,所以在重启后会回来。 在 Windows 上创建登录任务 caddis-hub。当 Windows 拒绝任务时(对于不是管理员的用户来说,“拒绝访问”),它表示 caddis-hub.vbs 在您的启动文件夹中, 信件中写着它用的哪个 . caddis hub autostart status 显示已设置的; caddis hub autostart disable 将两者去掉.

最后一个登录. 运行 caddis hub open 获取一次性登录码并打开中枢. 您的会话持续7天,没有使用,最多30天, 它从一个中心重启中存活下来.

时间线第一,董事会第二. 路线图和计划默认在时间线视图上打开,审计委员会视其为第二个选项。 点击时间线上的任何相位平板来打开相位面板并读取其跟踪器状态,PR链接和计划部分文本.

分支进展. 一个公开的PR修改计划显示PR分支的Tracker和 status:带着徽章 on branch (PR #n)。在主干线上完成后永远不再返回,叉子不显示。 中心读取来自GitHub的PR头和来自本地的分站对接,从不取取. 没有公关数据 上面的线说 branch progress off (no PR data)。 。 。 . caddis hub export --prs <file> 取输出 gh pr list --json number,headRefName,isDraft,isCrossRepository,updatedAt。“导出”从不公布分支名称,而“隐私”只出现在分支内容中只公布主要内容.

指南海报和细节. 《指南》的网页有: Poster 选项卡(与 Workflow 财务报告和审定财务报表 Mind map 视图,加a Print a3 风景墙海报)和 Details 选项卡。 海报上的每件物品都链接到它在"细节"中的条目.

指南墙海报. 第三个标签, Wall poster (单位:千美元)#/guide/wall),显示了一个A4景观表:按顺序排列的每日命令,每个舞台的卡片(计划,建设,审查,船舶,连续性,知识,设置),以及代理. 这个 Print 按钮在一页上准确打印工作表。 它由与其他标签相同的已安装的向导数据所构建,所以一个新的命令、代理或计数本身在之后出现 caddis update 并启动中枢。 文字在向导成长时会收缩(最多为60%),所以没有被切断. 每行是描述的第一条;"细节"标签有全文.

向导地图. 第四个标签, Map (单位:千美元)#/guide/map),列出整个插件:每日循环(计划、建设、审查、船舶)及其命令,辅助道(持续、知识、设置),钩子作为会话解雇它们的时间表,代理商及其模型和一个 writes files 标记,按家庭分列的技能,以及接收caddis的运行时间。 每个名字都链接到它在"细节"中的条目. 过滤箱会暗指不匹配的东西,而且 Print 在 A3 地貌上打印地图。 地图上的任何内容都不是由手书写的: 它是从安装的向导数据中构建的,所以一个新的命令,代理,技能或钩子本身在之后出现 caddis update 并启动中枢.

多个代理的会话. 克劳德代码会话来自 claude agents --json疯狂的 (Antigravity)会话来自caddis agy hooks:每个gy turn会写一个状态文件,并且 中枢以 agy 芯片。 芯片。 开始的一转 working。结束的一转 waiting (等待您,45 s之后). 10分钟未写入的会话 idle除非它等待 和它的疯狂过程仍然运行。 中枢在其进程时会降会话 停止或当它没有写到24小时。 无头运行( E)CADDIS_HEADLESS)无所写.

任何其他代理都可以以同样的方式显示其会话. 每个会话写一个 JSON 文件到 ~/.caddis/sessions/<session-id>.json (单位:千美元)CADDIS_HOME 替换主文件夹)。 写入临时文件 在文件夹中,然后重命名为目标:

{
  "session_id": "c0ffee-1234",
  "harness": "my-agent",
  "caddis_version": "1.3.200",
  "pid": 4242,
  "started": 1793000000.0,
  "last_seen": 1793000300.0,
  "status": "waiting",
  "status_since": 1793000300.0,
  "cwd": "/work/shop",
  "repo_path": "/work/shop",
  "waiting_for": "input needed"
}

• 时间是Unix秒. status 实值 working 或者说 waiting; 中枢忽略一个没有文件的文件.
• pid 是代理人自己的程序,或者 null 当它不知道的时候。 带了个活塞 中心就掉了 当进程停止时,会话。 没有了,只有时间.
• harness 给探员起名 中枢跳过 claude,因为克劳德代码会话来自 claude agents。 。 。 .
• cwd 将届会置于重播之下. waiting_for 这是很短的理由;等待时显示.
• 前六个键是会话心跳 caddis doctor 已经读取。 不取出他们.

删除 Caddis

没有 caddis remove。 。 。 . 此 CLI 安装并更新; 它永远不会卸载 。 清除去 通过每个特工自己的指挥——与这里其他一切相同的原则:

claude plugin uninstall caddis@caddis         # Claude Code
claude plugin uninstall caddis-extras@caddis
agy plugin uninstall caddis                   # agy
agy plugin uninstall caddis-extras

npm uninstall -g @caddis/cli 删除 只有这个CLI,而不是它安装到的 caddis 插件 你的探员 如果你想让Caddis完全消失的话 先把那些装好.

旗帜

旗帜在子命令之前或之后工作 : caddis update --dry-run 财务报告和审定财务报表 caddis --dry-run update 都一样.

总是可以安全预览 :

$ caddis update --dry-run
  · Claude Code — dry run — nothing executed
      would run: claude plugin marketplace update caddis
      would run: claude plugin update caddis@caddis
  · agy (Antigravity) — dry run — nothing executed
      would run: agy plugin install <shipped bundle>

Caddis 内容来自何处

卡迪丝把船捆了起来 在此 npm 包内, 与 CLI —— Caddis 相锁 安装是获得的卡地斯,没有额外的取回。 这就是为什么柏油球是几个MB: 搭载核心的疯狂捆绑和可选的 caddis-extras 图书馆. doctor 比较每个代理安装的 与所运出版本相对应的版本;这种区别就是"驱动"的通篇含义.

许可证

麻省理工学院