19 附录

附录 · kiro-cli 命令速查

本速查覆盖两类命令：在终端里敲的 CLI 子命令与参数，和进入 kiro-cli chat 会话后敲的斜杠命令。

命令随版本变化，用前以 kiro-cli --version 核对版本，再用 kiro-cli --help-all 和会话内 /help 看当前实际支持。

一、CLI 子命令

在终端里敲 kiro-cli <子命令>。

子命令作用
chat和 Kiro 对话（不带子命令时，kiro-cli 默认进 chat）
agent管理 agent 配置
mcp管理 MCP（Model Context Protocol）服务
crew启动 Kiro Crew，或把参数转发给它的命令行
settings查看或修改配置项
update更新 Kiro CLI
version显示版本信息和 changelog
doctor诊断并修复常见安装与配置问题
diagnostic运行诊断、生成系统信息报告（与 doctor 不同，侧重报告）
login / logout登录 / 登出
whoami显示当前用户与认证状态
theme查看或设置自动补全下拉菜单的主题
translate自然语言转 shell 命令
integrations管理系统集成（如 kiro-command-router）
inline管理行内补全（ghost text）
issue新建一个 GitHub issue（反馈或报 bug）

acp（Agent Client Protocol）另有独立文档页，不在主命令参考表里。

子命令的子命令

常用子命令还有下一层，用 kiro-cli <子命令> --help 查：

二、启动 chat 的常用参数

kiro-cli chat [OPTIONS] [INPUT]，INPUT 是开场要问的第一句话。

参数作用
--agent <AGENT>用指定的 agent 启动
--effort <LEVEL>初始思考档位：low / medium / high / xhigh / max
--no-interactive不进交互模式，把首条响应打到 STDOUT（适合脚本）
-a, --trust-all-tools允许模型调用任何工具、不再逐次确认
--trust-tools <TOOLS>只预批这组工具（非交互 V3 匹配内部 tool ID，交互 V3 忽略此参数，2.x 用自己的 tool 名）
--sandboxV3 无头运行时要求本地命令沙箱，配合 --no-interactive 或 --output-format stream-json
--require-mcp-startup有 MCP 服务启动失败就以 code 3 退出
--wrap <MODE>换行模式：always / never / auto（默认）
-r, --resume接续当前目录最近一次会话
--resume-id <ID>按会话 ID 接续本地或云端会话
--resume-picker交互式选一个会话接续
--list-sessions列出当前目录保存的全部会话
--delete-session <ID>按 ID 删除保存的会话
--list-models显示可用模型（配合 --format json 输出 JSON）
--cloud在托管云沙箱里跑 V3 会话
--repo <owner/repo>给 V3 云会话绑定一个或多个仓库（逗号分隔）

引擎开关（根命令和 chat 都接受）：--v3 用 V3 harness，--v2 用 V2 harness，两者互斥；全名是 --agent-engine <v1\|v2\|v3>。

全局参数（任何命令可用）：-v/--verbose、-V/--version、-h/--help、--help-all。

三、会话内斜杠命令

进入 kiro-cli chat 后敲，用 /help 看当前全部命令。

会话与上下文

命令作用用法
/chat新开、接续、保存或加载会话/chat [new [prompt]|resume|save <file>.zip|load <file>.zip]
/clear清空当前会话历史（保留同一 session）/clear
/compact压缩对话历史/compact
/context管理上下文文件或查看 token 用量/context [show|add <path>...|remove <path>...|clear]
/rewind回退到之前某一轮（分叉成新会话）/rewind
/reply用编辑器打开，引用上一条助手消息来回复/reply
/copy复制上一条助手回复/copy
/transcript查看或导出对话/transcript [--plain|--json|save]
/sessions打开会话面板（V3）/sessions
/session-id打印当前 session ID/session-id

agent、模型与能力

命令作用用法
/agent选择或管理 agent/agent [list|create <name>|edit [name]|swap <name>|set-default]
/model选择或列出可用模型/model [model-name|set-current-as-default]
/effort设置本次会话的思考档位/effort [level|set-current-as-default]
/plan切到 Plan agent，把想法拆成实现计划/plan [prompt]
/spec管理 specs/spec [new|run|view|analyze_requirements]
/workflow声明式工作流/workflow [run|new|list|status|pause|resume|cancel|retry]
/spawn并行起一个 agent 会话/spawn
/goal设一个带验证条件、可迭代完成的目标/goal [description --validate criteria] | clear
/tools查看可用工具/tools [trust-all|trust <name>|untrust <name>|reset]
/prompts选择或列出可用提示词/prompts [list|get|create|edit|remove]
/hooks查看已配置的 hook/hooks
/knowledge管理知识库/knowledge [show|add <name> <path>|search|remove|update|clear|cancel]
/mcp查看已配置的 MCP 服务/mcp [list|auth|logout]
/powers管理 powers（本地 V3）/powers [list|install|uninstall]
/code代码智能工作区管理/code [init|overview|status|logs]
/config查看本会话的 agent/MCP/Powers/Steering/Skills/Hooks（V3）/config

界面、输入与其他

命令作用用法
/editor打开编辑器写长 prompt/editor
/paste从剪贴板粘贴图片/paste
/title设置终端窗口标题/title
/fullscreen全屏模式/fullscreen
/theme设置会话配色/theme
/settings打开设置/settings
/usage查看计费和用量/usage
/changelog查看 changelog/changelog
/guide向 Guide agent 问 Kiro CLI 功能（仅终端 UI）/guide [question]
/issue新建 GitHub issue 或提功能请求/issue
/logdump导出日志供排错/logdump
/help列出可用命令/help
/quit退出（别名 /exit、/q）/quit

/stats（显示请求 ID 和耗时）官方文档标为”从 tab 补全里隐藏，但直接敲可用”。/checkpoint、/tangent、/autonomous、/sandbox、/experiment、/todo 等是实验或本地 V3 特性，用前以 /help 确认当前版本是否提供。安装的 skill 会以 /<skill名> 形式自动成为斜杠命令。

出处