CLI 参考

本页列出常用 pipeline 命令族。精确参数以 pipeline <command> --help 为准。

Setup 与运行时

tenon setup --codex
tenon setup --claude
tenon update --codex
tenon host-target-plan --json
tenon host-target-plan --host codex --operation setup --json
tenon doctor --json
tenon runtime status
tenon runtime repair --rollback
tenon dashboard --open

host-target-plan 是机器可读的只读契约。仅传 --json 时返回已注册宿主目录；同时传入 --host 与 --operation setup|update 时返回一个 host-target-plan/v1 计划。 它不会执行 setup/update，也不接受自定义宿主 ID。原生宿主计划面向用户级安装；适配器宿主 计划固定使用 --target .，复制或运行前必须先进入目标项目目录。

Change 与状态

tenon init <name> --track <track> --preset <preset>
tenon init <name> --track frontend --preset full --document-locale zh-CN
tenon list --json
tenon status <name> --json
tenon workflow plan <name> --json
tenon get <name> <field>
tenon set <name> <field> <value>
tenon transition <name> <event>
tenon check <name>

不要用 set phase 绕过 workflow event。canonical state 和 YAML projection 只能由 CLI 写。

tenon workflow plan <name> --json 是 Agent 编排在途 Change 的单一读取入口。它优先返回 WorkflowRun 初始化时冻结的完整计划，包括步骤、Skill、门禁、守卫、产物和转换。后来修改或删除 .pipeline/workflows/<workflow>.yaml 只影响新运行，不会改写已有运行的 Todo 和 Skill DAG。

文档证据

tenon document init <change>
tenon document scaffold <change> <kind>
tenon document scaffold <change> delta-spec --capability <capability>
tenon document record <change> <kind> <path> --producer <skill>
tenon document read <change> all
tenon document status <change> --json

scaffold 只创建缺失结构，不登记 producer；delta spec 必须显式提供真实 capability；record 必须对应真实 Skill。Change 语言固定在 .pipeline-document-locale.json，不写入严格 canonical schema，以保持旧版本回滚兼容。

项目规格骨架

tenon scaffold spec web
tenon scaffold spec cli --spec-dir docs/specs
tenon scaffold spec lib --document-locale en

项目规格骨架也默认生成中文。只有显式传入 --document-locale en 才生成英文；路径、命令、OpenSpec 与 workflow token 始终保持英文。冲突策略使用 --strategy skip|overwrite|append。 overwrite 会在可信项目根下先构建完整顶层项目 envelope，再以持久事务收据提交；进程在目录 切换中崩溃时，下一次调用会先恢复上一事务。检测到仍存活的 writer，或旧 envelope 移走后正式 路径被未知内容占用时，命令会 fail-closed 并保留 lock/stage/backup 恢复证据。

Review

tenon review request <change> --event <event>
tenon review acknowledge <change>
tenon review acknowledge <change> --delegated

delegated 需要 Change 绑定的持续授权，且不能跳过 check。

Session 与恢复

tenon session activate <change>
tenon session activate <change> --continuous --host-session <id>
tenon session route-context <change> --json

自动化与高级命令

tenon afk enqueue <change>
tenon loops list
tenon inbox --json
tenon handoff <change> --json
tenon tap ...
tenon channel ...

高级命令可能处理本地敏感数据，先阅读对应安全说明。