CLI 参数与子命令

sid-code 的全部命令行参数与子命令。

共 69 个参数条目、7 个子命令。 描述取自 sid-code --help，并与 packages/cli/src/cli.ts 的 parseArgs 声明 （参数能不能用的唯一权威，共 67 个 flag）交叉对账： "能用但没写"和"写了但不能用"两类缺陷都会让对账测试失败。 两个数不相等是口径不同、不是对账没对平：条目按帮助文本的行计，65 条各对应 1 个顶层 flag；4 条不对应顶层声明（-r, --resume [值]、--no-session-persistence、--worktree[=<name>]、--build-info [--json]：取反式或快速路径入口）；2 个声明了但刻意不写进帮助（--dump-tools、--session-persistence）。

子命令

子命令	说明
sid-code review	代码审查（从 stdin 或 --diff 文件读取 unified diff）（用法见下文）
sid-code daemon	本地调度守护进程管理（用法见下文）
sid-code update	下载并替换二进制到最新版（不动 ~/.sid-code/ 数据）（用法见下文）
sid-code agents	列出所有可用子代理（内置/自定义/插件）（用法见下文）
sid-code plugin	管理插件（与 /plugin 同一实现，不启动会话，供脚本 / CI 使用）（用法见下文）
sid-code mcp	管理 MCP 服务器配置（不启动会话）（用法见下文）
sid-code auth	企业登录（飞书）与认证诊断（用法见下文）

sid-code review

用法: sid-code review [--diff <path>] [--model <model>] [--timeout <ms>]
示例: git diff main...HEAD | sid-code review
      sid-code review --diff /tmp/pr.diff --model deepseek-v4-pro

sid-code daemon

用法: sid-code daemon <start|status|stop|restart> [选项]
选项: --webhook            启用 webhook 源
      --interval <ms>     调度检查间隔（默认 60000）
      --max-concurrent <n> 最大并发 headless job（默认 3）
      --allowed-tools <a,b> 全局兜底工具白名单

sid-code update

用法: sid-code update [--version x.y.z] [--list]
选项: --version x.y.z  安装指定版本
      --list           列出可安装的历史版本（标注 stable / beta / 当前）

sid-code agents

用法: sid-code agents [--json] [--setting-sources user,project,local]

sid-code plugin

用法: sid-code plugin <list|market|marketplaces|info|install|update|uninstall|enable|disable> [参数]
示例: sid-code plugin market
      sid-code plugin install my-skill@sid-code

sid-code mcp

用法: sid-code mcp <list|get|add|remove|pending|approve|reject|serve> [参数] [--json]
示例: sid-code mcp list
      sid-code mcp add fs npx -y @modelcontextprotocol/server-filesystem /tmp --scope user
      sid-code mcp remove fs

sid-code auth

用法: sid-code auth <login|logout|status> [--json] [--verify]
别名: sid-code login / sid-code logout
login 需先配置 backend.url（或 SID_CODE_BACKEND_URL）
status 逐条列出企业通道；--verify 对每条发一次不写数据的探测

LLM 配置

参数	说明
--provider <name>	LLM 提供商协议族 (anthropic/openai/ollama；openai 族含 Chat Completions 与 Responses)
-m, --model <name>	模型名称
--fallback-model <name>	主模型失败时的降级模型（须在 available_models 中）
--max-tokens <n>	响应最大 token 数
--effort <level>	推理强度档位 (low/medium/high/xhigh/max/auto)
--language <lang>	输出语言偏好 (zh/en/auto/unset)；也可用 SID_LANGUAGE 环境变量

权限配置

参数	说明
--permission-mode <mode>	权限模式 (default/always-allow/deny-write/acceptEdits/plan/dontAsk/auto/dangerously-skip-permissions；manual 为 default 的别名)
--dangerously-skip-permissions	跳过所有权限检查（仅限沙箱环境）
-y, --yes	自动批准需确认的操作（危险命令仍拦截；跳过全部检查用 --dangerously-skip-permissions）
--trust-workspace	仅本会话信任当前工作区（项目级 hooks / MCP 照常加载，不写入信任记录）
--allowed-tools <list>	免确认工具规则（逗号/空格分隔，认 CC 名与模式，如 "Read,Bash(git *)"）
--disallowed-tools <list>	工具黑名单（逗号分隔）
--allow-tool <rule>	追加允许规则（规则语法，如 "Bash(git status)"；可重复或逗号分隔）
--deny-tool <rule>	追加拒绝规则（同上语法；拒绝优先于允许）
--tools <list>	替换整个内置工具集（逗号分隔；未列出的工具不注册）
--add-dir <dir>	追加可访问目录（可重复：--add-dir A --add-dir B）

会话配置

参数	说明
-c, --continue	继续最近一次会话
-r, --resume [值]	恢复会话：不带值打开交互式选择器（可搜索）， 带值按 ID/索引恢复，未命中则作为搜索词进选择器
--session-id <uuid>	指定会话 UUID（须合法 UUID；与 -c/-r 同用须配 --fork-session）
--fork-session	恢复会话时分叉为新会话（新 id，不改动源会话）
--no-session-persistence	禁用会话落盘（本次会话不写持久化存储）
--from-pr <number>	从 PR 恢复会话上下文（gh pr view；内嵌会话 id 则恢复，否则注入 PR 上下文）
-n, --name <name>	会话显示名（便于 --list-sessions 辨识）
--list-sessions	列出所有会话（文本模式）
--browse-sessions	打开 TUI 会话浏览器
--delete-session <id>	删除指定会话
--cleanup-sessions	手动触发会话清理

无头模式

参数	说明
-p, --print	无头模式（非交互式，需提供提示词或管道输入） 提示词以 / 开头时按斜杠命令分发：自定义命令 / skill / 插件 / MCP prompt 展开后交给模型；交互与管理类内置命令报错退出（如 /plugin → sid-code plugin）
--input-format <fmt>	输入格式 (text/stream-json，默认 text；stream-json 从 stdin 逐条读消息， 且必须同时指定 --output-format stream-json)
--output-format <fmt>	输出格式 (text/json/stream-json，默认 text)
--include-partial-messages	转发 token 级增量（仅 -p 且 --output-format stream-json 时有效）
--max-turns <n>	Agent 循环最大轮次
--verbose	详细输出（stream-json 必需；json 下输出全量消息数组而非仅最终消息）
--json-schema <json|path>	结构化输出 JSON Schema（内联 JSON，或以 { 之外字符开头的文件路径）

系统提示词

参数	说明
--system-prompt <text>	覆盖系统提示词
--append-system-prompt <text>	追加到系统提示词
--system-prompt-file <path>	从文件加载系统提示词
--append-system-prompt-file <path>	从文件读取内容追加到系统提示词

插件

参数	说明
--plugin-dir <path>	会话级插件目录（可重复：--plugin-dir A --plugin-dir B）

配置源

参数	说明
--settings <file-or-json>	额外 settings 源（文件路径或内联 JSON，最后一层覆盖）
--setting-sources <sources>	限定加载的 settings 源（逗号分隔，子集：user/project/local）

MCP

参数	说明
--mcp-config <config>	额外 MCP 配置源（文件路径或内联 JSON，可重复）
--strict-mcp-config	仅用 --mcp-config 指定的服务器，忽略其它来源

子代理

参数	说明
--agents <json>	注入子代理定义（内联 JSON: {name:{description,prompt,...}}）
--agent <name>	整会话使用指定的顶层子代理人格

模型行为

参数	说明
--betas <beta>	额外 anthropic-beta 头值（可重复或逗号分隔）

限制控制

参数	说明
--max-budget-usd <amount>	花费上限（美元，超限终止；与 quota.costLimit 取更严的）

IDE

参数	说明
--ide	启动即自动连接 IDE（等价 SID_CODE_AUTO_CONNECT_IDE=true）

功能开关

参数	说明
--disable-slash-commands	禁用所有斜杠命令：/xxx 原样作为提示词交给模型（TUI 与 -p 同口径）

调试

参数	说明
-d, --debug	启用调试模式（日志输出到 ~/.sid-code/debug.log）
--debug-level <level>	日志级别 (ERROR/WARN/INFO/DEBUG，默认 DEBUG)
--debug-log-file <path>	自定义日志文件路径

轨迹采集

参数	说明
--trace / --no-trace	启用/禁用轨迹采集（默认启用，本地保存到 ~/.sid-code/trajectories/）
--trace-upload-disabled	强制禁用自动上传（覆盖配置文件，最高优先级）
--trace-upload-url <url>	轨迹上传平台地址（CLI 覆盖配置文件）
--trace-upload-token <tok>	上传认证 token（CLI 覆盖配置文件）
--trace-user-id <id>	用户标识（多用户场景）
--trace-device-id <id>	设备标识
--upload-traces	手动触发重试队列补传（处理之前失败的上传）；只传配置上传之后产生的会话
--include-history	与 --upload-traces 连用：连配置上传之前的历史会话一起上传（先列出数量与时间范围）

UI

参数	说明
--inline	主屏内联模式（现已是默认）：历史进终端原生 scrollback、 鼠标原生选中复制。显式写出只为兼容旧脚本。
--alternate-buffer	全屏 Alternate Buffer 有界视口（应用内虚拟滚动 + 鼠标滚轮 + Ctrl+S Copy Mode）。需要固定视口高度、不让历史进 scrollback 时用。

Bridge 远程控制

参数	说明
--bridge <ws-url>	进入 Bridge 模式，连接中继服务器接受远程客户端操控（ws:// 或 wss://）
--bridge-token <token>	Bridge 连接认证令牌
--bridge-insecure	允许明文 ws:// 连接（远端指令与 token 会明文过网，仅限可信内网）

Worktree 隔离

参数	说明
--worktree[=<name>]	启动即创建并进入隔离 Git Worktree（仅交互模式； 省略 name 自动命名为 brave-eagle-42 形态。名字用等号： --worktree=foo；裸 --worktree 后的词当提示词，不当名字）

其他

参数	说明
-h, --help	显示帮助信息
-v, --version	显示版本信息
--build-info [--json]	显示构建身份（编进二进制的 commit/branch/dirty/built_at） 版本号一个值对应几十个 commit，问"这个包是哪来的"要用它