Kilo Code CLI 命令速查表解析：从 25 个顶层命令到源码级生成机制

2026-09-11 10:07:47作者：羿妍玫Ivan

Kilo Code（kilocode 仓库）是一款面向终端的一体化 AI 编码代理平台。本文围绕仓库中自动生成的 CLI 命令速查表展开，完整解析其收录的 25 个顶层命令、每个命令的参数与子命令细节，并结合命令行参考文档与 CLI 源码实现，说明该速查表是如何被自动生成、如何与发布版二进制保持同步的。读完本文，你将能独立查阅、理解并上手 Kilo Code CLI 的全部顶层命令。

速查表的定位：CLI 文档的入口索引

cli-commands-table.md 位于 packages/kilo-docs/markdoc/partials/，是一个被 CLI 总览页通过 Markdoc partial 机制引用的片段：

{% partial file="cli-commands-table.md" /%}

也就是说，用户看到的“Top-Level CLI Commands”表格，实际内容来自该 partial 文件。而速查表本身只是一张"命令名 + 一句话描述"的索引表，命令的完整帮助信息（子命令、参数、默认值）由另一份自动生成的文档承载——即 CLI Command Reference。速查表在文档中的角色可以概括为：

给读者快速浏览：一眼看到 Kilo 提供了哪些能力域；
给搜索引擎/Agent 提供结构化入口：每个命令名都是精确的 CLI 标识符；
与发布版 CLI 保持强一致：表格不是手写的，而是由源码生成（见下文“生成机制”）。

速查表全文：25 个顶层命令一览

以下为速查表收录的全部命令（与仓库中的 cli-commands-table.md 完全一致）：

Command	Description
`kilo acp`	start ACP (Agent Client Protocol) server
`kilo mcp`	manage MCP (Model Context Protocol) servers
`kilo [project]`	start kilo tui
`kilo attach <url>`	attach to a running kilo server
`kilo run [message..]`	run kilo with a message
`kilo debug`	debugging and troubleshooting tools
`kilo auth`	manage AI providers and credentials
`kilo agent`	manage agents
`kilo upgrade [target]`	upgrade kilo to the latest or a specific version
`kilo uninstall`	uninstall kilo and remove all related files
`kilo serve`	starts a headless kilo server
`kilo models [provider]`	list all available models
`kilo roll-call <filter>`	batch-test text models matching a filter for connectivity and latency
`kilo profile`	show Kilo account profile
`kilo stats`	show token usage and cost statistics
`kilo export [sessionID]`	export session data as JSON
`kilo import <file>`	import session data from JSON file or URL
`kilo github`	manage GitHub agent
`kilo pr`	manage pull requests
`kilo session`	manage sessions
`kilo remote`	enable remote connection for real-time session relay
`kilo daemon`	manage the local kilo daemon
`kilo console`	open or stop the local Kilo Console (deprecated)
`kilo cloud`	run Cloud Agent tasks
`kilo db`	database tools
`kilo config`	configuration tools
`kilo plugin <module>`	install plugin and update config
`kilo help [command]`	show full CLI reference
`kilo completion`	generate shell completion script

表格中使用了三种位置参数标记：[project]（方括号，可选）、<url>（尖括号，必填）、[message..]（方括号加省略号，可重复的可选参数）。

命令背后的源码：从 commands.ts 到速查表

速查表中的每条命令都对应 packages/opencode/src/kilocode/commands.ts 中的一个 yargs CommandModule。该文件注释明确说明其用途："All CommandModules in one place so help.ts and generate-cli-docs.ts can introspect them without importing index.ts (which has startup side effects)."——即将所有命令模块集中注册，使得帮助生成与文档生成可以静态地内省命令列表，而无需触发 index.ts 的启动副作用。

从源码结构可以看到几个值得注意的细节：

开发专用命令会被剔除：dev-setup 与 dev-alias 仅在 InstallationBuildKind !== "release" 时被加入 commands 数组。也就是说发布版二进制中不存在这两个命令，对应地速查表和参考文档中也不会出现它们，保证"文档 = 发布版能力"。
completion 是合成的：yargs 内置的 .completion() 行为被包成一个 CompletionCommand 模块（见 commands.ts），以便被文档生成流程统一收录。
模块化按域拆分：每个命令实现在 packages/opencode/src/kilocode/cli/cmd/ 目录下各自独立成文件（如 acp.ts、mcp.ts、roll-call.ts、daemon.ts 等），便于维护与按需懒加载。

自动生成机制：文档与 CLI 永不脱节

速查表文件第一行标注着：

<!-- Auto-generated by script/generate-cli-docs.ts — do not edit manually -->

这并非装饰性注释。仓库根目录的 script/generate-cli-docs.ts 读取 commands.ts 中的命令列表，过滤掉 dev-only 命令后，调用 packages/opencode/src/kilocode/help.ts 提供的两个生成函数：

generateCommandTable({ commands })——生成速查表（即本文件）；
generateHelp({ all: true, format: "md", commands })——生成完整的 CLI Command Reference。

随后用 Bun 写入两个目标文件：

const TABLE_PATH = root + "packages/kilo-docs/markdoc/partials/cli-commands-table.md"
const REFERENCE_PATH = root + "packages/kilo-docs/pages/code-with-ai/platforms/cli-reference.md"

const table = await generateCommandTable({ commands: publicCommands })
await Bun.write(TABLE_PATH, `<!-- Auto-generated by script/generate-cli-docs.ts — do not edit manually -->\n\n${table}`)

const reference = (await generateHelp({ all: true, format: "md", commands: publicCommands })).replaceAll(cwd, ".")
await Bun.write(REFERENCE_PATH, /* ... */)

生成流程由 script/generate.ts 统一编排（bun ./script/generate-cli-docs.ts）。此外，仓库还通过 CI 脚本 script/check-kilo-generated-artifacts.ts 之类的检查保证生成产物与源码一致，防止手工改动被合入。

从 help.ts 的实现可以进一步看到生成细节：

generateCommandTable 遍历命令列表，仅收录 describe 非空且命令名可解析的模块，行格式为 | `kilo xxx` | description |；
表格分隔符采用紧凑形式 |---|---|，注释中特别说明：仓库通过 script/check-md-table-padding.ts 强制要求 markdown 表格分隔符不加内边距，加宽版本会导致 CI 失败；
generateHelp 通过 yargs 实例逐命令渲染帮助文本，并用 yargs 18 的内部 API（getInternalMethods()）递归提取子命令及其帮助，深度上限为 4 层以防死循环；ANSI 颜色码会被 strip() 剥离，确保生成的是纯文本/纯 Markdown。

高频命令实战要点

`kilo run`：无头执行，消息即任务

kilo run [message..] 以非交互方式把一条消息交给 Agent。从 CLI Command Reference 中可以看到其关键选项：

--command：指定要运行的自定义命令，message 作为其参数；
-c/--continue、-s/--session、--fork、--cloud-fork：接续历史会话或从云端拉取会话继续；
-m/--model：以 provider/model 格式选择模型；
--format：输出格式，可选 default（格式化输出）或 json（原始 JSON 事件流）；
-f/--file：随消息附加文件（可重复）；
--attach：附加到正在运行的 kilo server（如 http://localhost:4096）；
-i/--interactive：直接进入交互式分屏模式；
--auto：自动批准未被显式拒绝的权限（危险操作，默认 false）。

典型用法：

# 单条消息任务
kilo run "重构 src/utils.ts 中的错误处理"

# 指定模型并以 JSON 事件流输出
kilo run -m anthropic/claude-sonnet-4-5 --format json "分析当前目录结构"

# 附加文件执行
kilo run -f ./package.json "解释这个项目的依赖关系"

`kilo attach`：接入运行中的服务器

kilo attach <url> 用于连接一个正在运行的 kilo server（例如 kilo serve 或 TUI 启动的本地服务）。参考文档给出的默认地址示例是 http://localhost:4096。它支持 -s/--session 接续指定会话、-p/--password 与 -u/--username 进行 Basic Auth（用户名默认取 KILO_SERVER_USERNAME，否则为 kilo），以及 --mini 极简界面等选项。

`kilo roll-call`：批量探测模型连通性与延迟

kilo roll-call <filter> 是 Kilo 特有的实用工具，按正则过滤 provider/modelID，批量向匹配的文本模型发送测试提示并报告访问状态、返回片段与延迟。参数包括：

--prompt：发送给每个模型的提示（默认 Hello）；
--timeout：单次调用的超时毫秒数（默认 25000）；
--parallel：并发调用数（默认 5）；
--output：输出格式，可选 table / json / md（默认 table）。

其实现位于 packages/opencode/src/kilocode/cli/cmd/roll-call.ts。源码中两个细节值得注意：

懒加载依赖：roll-call 在 CLI 启动时即被注册，但 provider 服务、AppRuntime、AI SDK 等重依赖通过 loadDeps() 延迟导入，并以模块级 cache 缓存（每个进程只解析一次），避免为每个模型重复等待 import；
表格渲染：formatTable 输出 Model | Access | Snippet | Latency 四列表格，当总宽度超出终端宽度时优先压缩 Snippet 列（保留最小宽度），并对 ANSI 颜色码与控制字符做清洗（sanitize）、对过长片段做截断（truncate）。

`kilo auth` 与 `kilo models`：模型接入两件套

kilo auth 提供 list（列出已配置的 provider 与凭证）、login [url]（登录 provider，可用 -p/--provider 跳过选择）、logout [provider]；
kilo models [provider] 列出所有可用模型，可加 --verbose 查看包含成本在内的详细元数据，--refresh 则强制从 models.dev 刷新模型缓存。

会话与数据管理命令

会话导出导入

kilo export [sessionID]：将会话导出为 JSON；不传 ID 时导出全部会话；--sanitize 会脱敏敏感的 transcript 与文件数据，适合分享。
kilo import <file>：从 JSON 文件或分享 URL 导入会话。

统计与账号

kilo stats：显示 token 用量与成本统计，支持 --days（最近 N 天）、--tools（工具使用排行）、--models（按模型统计，传数字显示前 N 个）、--project（按项目过滤）等维度；
kilo profile：显示 Kilo 账号资料，--json 以 JSON 输出。

会话与 PR 工作流

kilo session：list（支持 -n/--max-count、-a 列出所有项目、-s 按标题过滤、--format table|json）与 delete <sessionID>；
kilo pr：checkout <number>（拉取并检出 PR 分支后直接运行 kilo）、link <url>（将当前 worktree 关联到 PR）、unlink、status。

服务、守护进程与云端能力

`kilo serve` 与 `kilo daemon`

kilo serve 启动无头服务器，供其他客户端（如 TUI、attach、run --attach）连接。它和 kilo acp、TUI 共享一组网络选项：--port（默认随机端口 0）、--hostname（默认 127.0.0.1）、--mdns（开启 mDNS 服务发现，同时把 hostname 默认改为 0.0.0.0）、--mdns-domain（默认 kilo.local）、--cors（额外的 CORS 允许域）。
kilo daemon 管理本地守护进程，子命令 start / status / stop / restart，支持 --json 输出与 -f/--foreground 前台运行。

`kilo acp` 与 `kilo mcp`：两大 Agent 协议

kilo acp 启动 Agent Client Protocol（ACP）服务器，让外部 Agent 客户端通过标准协议驱动 Kilo；
kilo mcp 管理 Model Context Protocol（MCP）服务器：add [name]（--url 添加远程服务器，--env KEY=VALUE 传环境变量，--header KEY=VALUE 传 HTTP 头）、list、auth [name]（OAuth 认证）、logout、debug。

`kilo cloud`：云端 Agent 任务

kilo cloud 提供 start（--prompt 必填，可选 --repo、--repo-type（github/gitlab/git）、--branch、--model、--mode、--org-id，--stream 可连接 WebSocket 流实时打印 JSONL 事件）、send（对 --session-id 指定的云端任务发送追问）、status 与 result（均需 --session-id 与 --message-id）。

维护、配置与底层工具

kilo upgrade [target]：升级到最新版或指定版本（如 0.1.48 / v0.1.48），-m/--method 可选安装方式：curl、npm、yarn、pnpm、bun、brew、choco、scoop；
kilo uninstall：卸载并清理文件，支持 -c/--keep-config、-d/--keep-data、--dry-run（预览将删除的内容）、-f/--force（跳过确认）；
kilo debug：排障工具集，涵盖 config（查看解析后的配置）、lsp（诊断、符号查询）、rg（ripgrep 调试）、file（文件系统调试）、scrap（列出已知项目）、skill（列出技能）、snapshot（快照调试）、startup（启动耗时）、agent <name>（查看 Agent 配置详情，可加 --tool 与 --params 直接执行工具）、v2、info、paths（全局数据/配置/缓存/状态路径）、wait；
kilo db：数据库工具，kilo db [query] 打开交互式 sqlite3 shell 或执行一条 SQL，--format json|tsv；kilo db path 打印数据库路径；
kilo config：config check 检查配置中的警告与错误；
kilo plugin <module>：安装 npm 插件模块并更新配置，-g/--global 安装到全局配置，-f/--force 覆盖已有版本；
kilo remote：为实时会话转发启用远程连接；
kilo console：打开/停止本地 Kilo Console，但已在文档中被明确标记为 deprecated，将在未来版本移除（见 cli.md 中的 callout 警告）；
kilo help [command]：查看完整 CLI 参考，--all 显示全部命令帮助，--format md|text 选择输出格式；
kilo completion：生成 shell 补全脚本。

如何让速查表为你所用

在终端内：kilo help 可查看全量命令；kilo help <command> 查看单个命令细节，与本文引用的 CLI Command Reference 内容同源；
在文档中：速查表是入口，参考文档是字典，二者均由 script/generate-cli-docs.ts 从 commands.ts 自动生成——当你看到文档中的命令与 kilo --help 输出不一致时，这本身就是一个值得上报的 bug，因为自动生成机制保证了二者应当严格同步；
在仓库中：若需深入某个命令的实现，可到 packages/opencode/src/kilocode/cli/cmd/ 目录按文件名定位对应模块，例如 roll-call.ts、daemon.ts、cloud.ts 等。