CLI 参考

suya 命令界面的详尽索引。下面的每个组都链接到它在 /cli/* 下的专属页面，以获取说明、示例和 标志细节。

全局标志

每个命令都接受：

标志	含义
--host	API 端点（默认 https://subaya-dev.com）
--token	认证令牌，优先级最高的凭据
--json	机器可读的 JSON 输出
--pretty	为人类格式化的输出
-q, --quiet	抑制非必要的输出
-v, --verbose	额外的诊断输出

面向 agent 和 CI 的认证使用 SUBAYA_API_KEY 环境变量——参见 认证与 API 密钥。位于 .subaya/config.toml 的本地项目配置持有项目 id， 因此大多数命令会从中默认 --project。

auth

参见 CLI: auth。

suya auth login [--no-browser]   # OAuth (loopback, falling back to the device flow)
suya auth logout                 # log out and revoke the local token
suya auth status                 # local auth status, no server call
suya auth whoami                 # call the API and print the resolved identity

project

参见 CLI: project。

suya project create --name <n> --workspace <id> --type <fpga|embedded> [--slug <s>] [--device <id>]
suya project init                # alias of create
suya project list --workspace <id>
suya project phase               # get or set the current project phase
suya project show                # defaults to the .subaya/config.toml project

repo

参见 CLI: repo。

suya repo create --installation <id> [--name <n>] [--project <id>]
suya repo connect --installation <id> --owner <o> --repo <r> [--project <id>]
suya repo status                 # connected repo + config state

sim

参见 CLI: sim。

suya sim run --tb <path> --top <module> [--project <id>] [--source <dir>] \
    [--tool ryusim|verilator|icarus|questa|renode] [--tier S] \
    [--wait] [--no-cache] [--arg <a>]...
suya sim list                    # recent runs
suya sim report <run-id>         # status + results summary
suya sim logs <run-id> [--follow]
suya sim rerun <run-id> [--wait]
suya sim wave <run-id>           # locate the waveform artifact (hand off to wf)

hw

通过 BitCrucible 进行硬件验证。参见 CLI: hw。

suya hw agent register --name <n>
suya hw agent list
suya hw agent revoke <id>
suya hw agent run
suya hw run --target <t> [--test-plan <file>]
suya hw history [--project <id>] [--limit N]

rag

检索和知识搜索。参见 CLI: rag。

suya rag search <query> [--scope curated|project:42]... [--top-k N] [--semantic-only]
suya rag read <chunk-id>         # full body of a curated chunk
suya rag status                  # per-scope chunk counts + last ingest timestamp

plan

规划产物。参见 CLI: plan。

suya plan docs list
suya plan docs show <id>
suya plan docs approve <id> [--section <s>]
suya plan items list
suya plan items show <id>        # work-item tree
suya plan diagrams ...
suya plan session                # prints how to open a planner session (suya attach)

arch

架构和嵌入式引脚规划。参见 CLI: arch。

suya arch module add --name <n> [--project <id>] [--kind <k>] [--description <d>] [--parent <pid>]
suya arch module list --project <id>
suya arch pin-plan create (--mcu <part> | --board <name>) [--project <id>] [--name <n>]
suya arch pin-plan list --project <id>
suya arch pin-plan show --plan <pid>
suya arch pin-plan review-doc --plan <pid>
suya arch pin-plan rm --plan <pid>                          # delete the plan + its pins/peripherals/clocks
suya arch pin set --plan <pid> --pin <PA5> --signal <USART2_TX> [--af --mode --label]
suya arch pin rm --plan <pid> --pin <PA5>                   # free a pin
suya arch peripheral configure --plan <pid> --peripheral <USART2> [--mode --params <json>]
suya arch peripheral rm --plan <pid> --peripheral <USART2>
suya arch clock set --plan <pid> ...     # clock-tree node intent
suya arch clock rm --plan <pid> --node <SYSCLK>
suya arch validate --plan <pid>          # structural validate (headless CubeMX authoritative)
suya arch generate --plan <pid> [--wait] # enqueue a headless CubeMX run; --wait polls + prints the resolved .ioc
suya arch generate-status --run <id>     # poll a generate run and print its resolved .ioc
suya arch ioc commit                     # generate the plan's .ioc and commit to connected repo

req

需求。参见 CLI: req。

suya req add --title <t> [--parent REQ-N]       # add a requirement
suya req list [filters] [--pretty|--tree]        # list (see filters below)
suya req show REQ-N                              # show one requirement
suya req update REQ-N --status deferred          # edit fields (>=1 required)
suya req rm REQ-N [--yes]                        # hard delete (confirm + reference warning)
suya req tag REQ-N --add console --rm old        # cross-cutting tags
suya req link REQ-N --to work_item:42 --to test:tests/boot.rs::cold_boot
suya req coverage [--untested]                   # leaf reqs with no linked test (CI gate)
suya req import --file specs.yaml                # bulk upsert on key
suya req export --format yaml|csv|md             # round-trip for review-by-diff
suya req baseline list | diff [<id>|latest]      # snapshot at approval vs drift

review

代码和设计审查。参见 CLI: review。

suya review create|show|list|comment|comments|reply|resolve|approve|request|reopen|close|rounds|diff

diagram

Mermaid 图表，通过 mmdc 渲染为 SVG/PNG。参见 CLI: diagram。

suya diagram create|update|show|list|export|render|delete

device

设备目录。参见 CLI: device。

suya device search [--type fpga|embedded]
suya device show <id>
suya device set <id>             # assign a device to a project

session

连接到并释放你的会话 pod。参见 CLI: session。

suya attach [--console|--no-console]   # attach to your session pod (reconnects)
suya detach                            # release the session pod for reaping

maintenance

顶层维护命令。参见 CLI: maintenance。

suya version                     # version metadata
suya update [--check]            # upgrade to the latest release
suya install [--skills] [--path <p>] [--force]   # install Subaya integrations
suya completion <shell>          # shell autocompletion