驾驶舱CLI
驾驶舱会观察你和你的人工智能特工是如何工作的，这样爱德华就可以根据证据而不是屏幕截图和状态ping进行指导。
90秒speedrun
在应该收集的Mac或Windows PC上运行此命令：
npm i -g @bli-cockpit/cli && cockpit doctor
医生安装、修理并验证机器。遵循任何登录或信任 提示它打印。它以托收证明或剩余行为结束。
每个命令，它做什么，为什么叫它
在一台空白的Mac或Windows电脑上， npm i -g @bli-cockpit/cli && cockpit doctor 足以登录，选择根，并收敛机器。 onboard 保留命名的设置子集，其余的用于恢复和维护。
Cockpit在苹果硅质Mac和普通Windows上的工作方式是一样的 电脑。所有经你批准的法典和克劳德会议都被收集起来， 在它离开你的机器之前把所有敏感的东西都拿走，然后 上传时附上收据，或者列出没有上传的确切原因。如果一个 座舱是这么说的——绿屏永远掩盖不了一个。
我们只会在一个版本端到端经过测试后才将它发布到npm 普通用户，在macOS和Windows上。
| 命令 | 它是做什么的 | 为什么会有这个名字 |
|---|---|---|
cockpit onboard | 命名的设置子集：让你登录（电子邮件代码），注册这台机器，开始捕获，上传一次，完成所有历史的Codex和Claude回填保存的批准根，安装15分钟的后台同步，然后打印证明你是活的。 | 你要登船了。 doctor 当设置丢失时调用此流；直接重新运行是安全的。部分或失败的回填块准备情况，并具有确切的重试原因。 |
cockpit doctor | 将Mac或Windows PC从空白或已登录状态聚合：最新的CLI，登录设备令牌，保存根，自动启动，历史回填，原始证据GC和新鲜同步。互动首先运行提示邮件OTP和收集根；无头/--json 运行explain并退出，而不是阻塞。 --dry-run 没有书面的预览。 | 爱德华可以打出一行，每个实习生的机器都应该是绿色的。它检查每一行，修复它，并验证结果。 |
cockpit status | 在一个屏幕中打印安装/登录/捕获/上传运行状况。 | “it is working?”命令。当你不确定的时候就运行它。 |
cockpit backfill --all | 上传你的历史法典+克劳德会议（从驾驶舱存在于这台机器之前）。发现默认深度为3和50个仓库；提高 --max-depth 或者 --max-repos 当返回的重试命令表示达到上限时。 | 只补一次，所以你过去的工作也算。“回填” =填回目录。 |
cockpit sync | 立即捕获并上传一次。这是后台代理每15分钟运行一次的内容——你几乎不用自己输入。 | 根据其功能命名：将本地会话文件同步到仪表板。 |
cockpit analyze | 运行一个新的同步，然后对最近上传的会话进行队列批处理分析。它立即返回；状态和结果显示在我的工作中。 | 一个命令，当你想要新完成的工作上传和判断现在。 |
cockpit start --ticket <id> | 标记你当前的工作与线性票证，所以会话属性到它。 --clear-ticket 返回常规捕获。 | “开始（做）x。”代理通常根据代理规则为您运行此操作。 |
cockpit login / cockpit pair | 只需登录+设备注册步骤，独立（板载已经包含它）。在新机器上也可以工作：它首先写一个最小的本地配置（没有收集根-运行） cockpit onboard 然后去登记)。两个名字，一个命令： login 是人类的猜测， pair 是仪表板上的设备屏幕上的名称。 | 当会话过期或切换帐户时，或者在新机器上首次登录时，恢复路径。 |
cockpit logout | 删除此机器的会话。 | 登录的撤销。 |
cockpit update / cockpit upgrade | 从npm更新CLI本身，然后在板上重新运行。两个名字，一个命令——别名，因为一半的人都猜对了。 | 的由来;当爱德华宣布有新版本时就跑。 |
cockpit install | 只写入本地配置（板载的第1步，独立）。 | 管道;存在，所以船上的部件是单独运行的。你可能永远都不会打字。 |
cockpit sessions | 只读：列出您观察到的会话以及每个会话的属性。 | 调试“为什么我的会话没有显示？”而不上传任何内容。 |
cockpit autostart install|uninstall|status | 管理macOS启动代理或每用户Windows任务调度任务后的15分钟后台同步。 | 当您需要停止/检查背景片时，可以直接控制它。 |
cockpit agent-rules install|uninstall|status | 管理驾驶舱票务绑定文本块内部 ~/.codex/AGENTS.md / ~/.claude/CLAUDE.md. | 这就是“你的探员读过的规则”。被动降价——从来没有一个可执行的钩子。 |
cockpit serve | 运行一个小型的本地HTTP状态服务器。 | 利基：让其他工具询问收集器它做得怎么样。 |
cockpit logout， cockpit release， cockpit admin * | release 发布CLI（维护者，repogated）； admin （引导/邀请）完全不在公共构建中。 | 维护表面-实习生从不接触这些。 |
诚实的命名注意事项： update/upgrade 和 login/pair 有意使用的同义词别名便宜吗
原谅胜过“找不到命令”)； install “写配置”是一个误导性的名字，但是
是为了保持机载步骤的对称性。
旗帜
正常设置不需要标志。仅在默认猜测错误时使用标志：
cockpit onboard --email <[email protected]> --workspace ~/BLI
cockpit onboard --workspace ~/BLI --workspace ~/side-projects
cockpit onboard --device-name "Ian MacBook"
cockpit onboard --no-auth
--email跳过电子邮件提示。--workspace销一个集合根；对多个不相关的根重复此步骤。- 从主文件夹进行交互式登录询问是否同步计算机上的所有项目。回答
y只有在公司的机器上收集每一个当前和未来的回购$HOME目的是。nor Enter要求输入实际的工作文件夹；如果没有选择有效的非主文件夹，座舱不会捕获任何内容并告诉您重新运行--workspace <path-to-your-work-folder>. --allow-home-root是无头/脚本形式的全家福选择。--device-name只改变驾驶舱中显示的人类标签。--dashboard-url仅用于登台/自定义仪表板。生产是默认的。--no-auth强制旧的手动审批队列。--repo仍然是一个遗留的别名--workspace.
cockpit doctor 是正常的舰队会聚命令。在交互式首次运行时，它使用与登录相同的电子邮件OTP登录和根选择器流程，然后重新检查机器。在无头，发射， --json，或者没有tty运行，它永远不会提示；缺失的authth或根与修复文本保持红色。 --dry-run 预览而不写auth或config。
cockpit update 安装最新的公共CLI，并根据保存的根重新运行登录检查。 cockpit upgrade 是同一个命令。
cockpit --version， cockpit -V, cockpit version 打印已安装的
公共包版本。Windows自动启动的详细信息和验证步骤
docs/runbooks/cockpit-windows-task-scheduler-sync.md.
分析最新工作
cockpit analyze --workspace "$PWD"
cockpit analyze 首先执行与 cockpit sync． 它
只有在上传成功后才对分析进行排队，然后无需等待就退出
用于“烟花”批次。使用 --json 的单个机器可读对象
包含同步接收和排队作业状态。仪表板按钮
分析后台收集器已经存储的最新上传；运行
当工作结束时间过短时，执行CLI命令进行15分钟的后台同步。
每个人可以每三小时进行一次队列分析，具体时间取决于团队
共享 $2 utc日裁判上限。完成可能需要几分钟加上等待
接下来的15分钟收集者投票；“我的工作”显示已排队、正在运行、已完成或
等待时的失败状态。
父模式
使用父文件夹，例如 ~/BLI 当它包含多个repos时。驾驶舱扫描子git的repo /工作树，为每个工作树创建一个稳定的工作上下文，并将它们卷到仪表板中的repo行下。
默认值：3个文件夹级别深，最多50个仓库。与 --max-depth 和 --max-repos.
配对复苏
v2幸福路径自动批准配对后，电子邮件OTP。恢复仍然存在手动审批：
cockpit onboard --no-auth --email <[email protected]> --workspace ~/BLI
当邮箱不可用、认证路由关闭或Edward添加了确切的非域电子邮件例外时，使用该选项。驾驶舱打印URL和代码；Admin审批来自Ambient -> Collector审批。如果代码过期，则重新运行 cockpit onboard 批准后，持久访问行将自动配对。
如果这是一个重用的笔记本电脑或虚拟机，保留 --email 集。驾驶舱只在现有会话属于相同的电子邮件和仪表板URL时重用它。
票的语义
设置是一般的环境捕获。不要发明登机票。
当真正的售票工作开始时：
cockpit start --ticket <ticket-id> --workspace "$PWD"
cockpit sync --workspace "$PWD" --json
对于重要的无票工作：
cockpit start \
--workspace "$PWD" \
--topic "lead ingestion planning" \
--intent planning \
--phase discovery \
--intent-confidence 0.9
cockpit onboard 中刷新受管理的票绑定指导 ~/.codex/AGENTS.md 和 ~/.claude/CLAUDE.md 因此，代理在确认的工作空间内编辑之前绑定可见的线性票。
存储布局
本地文件:
~/.config/bli-cockpit/config.json：仪表板URL，设备标签，集合根。~/.config/bli-cockpit/session.json配对的设备令牌和所有者元数据。~/.local/state/bli-cockpit/spool/：等待重试的上传。~/.local/state/bli-cockpit/spool/install-events/私有原子收集器 等待经过身份验证的交付的健康收据。收据只包含 净化操作元数据，从不使用命令输出或记录内容。~/.local/state/bli-cockpit/cursors/：书签显示上传的进度，没有原始内容。.codex-autorunner/contextspace/active_context.md： repo中的当前工作上下文。
远程数据:
- 批准的用户/设备标识；
- repo/worktree指纹，分支，head SHA，可选票证，源代码计数；
- 私人原始证据对象和
ambient_evidence_refs指针; - Codex/Claude会话归属元数据。
永远不要向这个CLI提供服务角色密钥、原始DB url、cookie、根环境文件或部署令牌。采集器从不读取env文件，也不收集随机的桌面截图或屏幕记录。
调试
cockpit sessions --workspace "$PWD" --json
cockpit status --workspace "$PWD" --json
cockpit sync --workspace "$PWD" --json
status --json 包括 pending_health_receipt_count，
oldest_pending_health_receipt_at,
last_health_receipt_failure_reason． 非零计数意味着驾驶舱保存了A
本地收集器失败，并将在下一次经过身份验证的运行时重播。
如果 cockpit update NPM失败 EACCES修复Homebrew全局包所有权一次：
sudo chown -R $(whoami) /opt/homebrew/lib/node_modules/@bli-cockpit /opt/homebrew/bin/cockpit
不要使用 sudo npm i -g;这又产生了所有权问题。