古法编程

Appearance

本文是 Kiro CLI 的全命令速查手册，涵盖全局参数（--verbose、--agent、--help）以及所有子命令：chat（交互对话）、agent（管理 Agent 配置）、translate（自然语言转 Shell）、doctor（诊断修复）、update（版本更新）、theme（主题切换）、integrations（系统集成）、inline（内联建议）、login/logout/whoami（身份验证）、settings（配置管理）、diagnostic（诊断报告）、mcp（MCP 服务器管理）等。每条命令附有语法、参数表和实用示例。

全局参数 ​

以下参数适用于所有 Kiro CLI 命令：

参数短形式说明
--verbose-v增加日志详细程度（可叠加：-v、-vv、-vvv）
--agent使用指定的自定义 Agent 配置启动会话
--help-h显示帮助信息
--version-V显示版本信息
--help-all打印所有子命令的帮助信息

kiro-cli chat ​

启动与 Kiro 的交互对话会话。不指定子命令时，kiro 默认等同于 kiro-cli chat。

语法：

kiro-cli chat [OPTIONS] [INPUT]
参数说明
--no-interactive以非交互模式将首条响应输出到 STDOUT
--resume / -r恢复当前目录的上一次对话
--resume-picker打开会话选择器，交互式选择要恢复的会话
--resume-id <ID>按 ID 恢复指定会话
--list-sessions列出当前目录的所有已保存会话
--list-models显示可用模型列表
--delete-session <ID>按 ID 删除指定会话
--agent指定要使用的 Agent
--trust-all-tools允许模型使用任意工具，无需确认
--trust-tools信任指定工具（逗号分隔）
--require-mcp-startup若任意 MCP 服务器启动失败则以代码 3 退出
--wrap折行模式：always、never 或 auto（默认）
INPUT第一个问题（位置参数）

示例：

bash
# 启动交互对话
kiro-cli

# 直接提问
kiro-cli chat "How do I list files in Linux?"

# 非交互模式，信任所有工具
kiro-cli chat --no-interactive --trust-all-tools "Show me the current directory"

# 恢复上次对话
kiro-cli chat --resume

# 按 ID 恢复指定会话
kiro-cli chat --resume-id abc123-def456

# 交互式选择会话恢复
kiro-cli chat --resume-picker

# 列出所有已保存会话
kiro-cli chat --list-sessions

# 列出可用模型（JSON 格式，适合脚本）
kiro-cli chat --list-models --format json

# 使用指定 Agent
kiro-cli chat --agent my-agent "Help me with AWS CLI"

会话管理 ​

Kiro CLI 在每次对话轮次后自动保存会话，可随时恢复。

命令行操作：

bash
# 恢复最近一次会话
kiro-cli chat --resume

# 交互式选择要恢复的会话
kiro-cli chat --resume-picker

# 列出当前目录所有已保存会话
kiro-cli chat --list-sessions

# 删除指定会话
kiro-cli chat --delete-session <SESSION_ID>

对话中使用 /chat 命令：

# 开启新对话（自动保存当前会话）
/chat new

# 以初始提示开启新对话
/chat new <PROMPT>

# 交互式选择并恢复会话
/chat resume

# 保存会话到文件
/chat save <FILE_PATH>

# 从文件加载会话
/chat load <FILE_PATH>

加载时 .json 扩展名可省略，Kiro 会自动尝试两种形式。

自定义会话存储：

可使用自定义脚本控制会话的保存与加载位置（版本控制、云存储、数据库等）：

# 通过脚本保存（脚本从 stdin 接收 JSON）
/chat save-via-script <SCRIPT_PATH>

# 通过脚本加载（脚本将 JSON 输出到 stdout）
/chat load-via-script <SCRIPT_PATH>

kiro-cli translate ​

将自然语言描述翻译为可执行的 Shell 命令。

语法：

kiro-cli translate [OPTIONS] [INPUT...]
参数短形式说明
--n-n生成候选命令的数量（最多 5 个）
INPUT自然语言描述（位置参数）

示例：

bash
kiro-cli translate "list all files in the current directory"
kiro-cli translate "find all Python files modified in the last week"
kiro-cli translate "compress all log files older than 30 days"
kiro-cli translate -n 3 "search for text in files"

kiro-cli doctor ​

诊断并修复常见的安装和配置问题。

语法：

kiro-cli doctor [OPTIONS]
参数短形式说明
--all-a运行所有诊断测试（不执行修复）
--strict-s将警告视为错误
--format-f输出格式：plain、json、json-pretty

kiro-cli update ​

将 Kiro CLI 更新到最新版本。

语法：

kiro-cli update [OPTIONS]
参数短形式说明
--non-interactive-y不提示确认，直接更新
--relaunch-dashboard更新后重新启动控制台（默认：true）

kiro-cli theme ​

获取或设置自动补全下拉菜单的视觉主题。

语法：

kiro-cli theme [OPTIONS] [THEME]
参数说明
--list列出所有可用主题
--folder显示主题目录路径
THEME主题名称：dark、light、system

kiro-cli integrations ​

管理 Kiro 的系统集成。

语法：

kiro-cli integrations [SUBCOMMAND] [OPTIONS]
子命令说明
install [integration]安装集成（如 kiro-command-router）
uninstall [integration]卸载集成
reinstall [integration]重新安装集成
status检查集成状态

选项：--silent / -s 抑制状态消息；--format / -f 指定输出格式。

Kiro Command Router（v1.26.0+） ​

Kiro Command Router 是统一入口，将 kiro 命令路由到 CLI 或 IDE。

默认情况下，kiro 命令启动 Kiro IDE。如果你更习惯用 App 图标打开 IDE、而希望命令行默认进入 CLI，可以安装此路由器：

bash
# 安装路由器
kiro-cli integrations install kiro-command-router

# 将 CLI 设为默认
kiro set-default cli

# 或将 IDE 设为默认
kiro set-default ide

安装后的行为：

  • kiro — 启动你设定的默认（CLI 或 IDE）
  • kiro-cli — 始终启动 CLI
  • kiro ide — 始终启动 IDE

kiro-cli inline ​

管理内联建议（ghost text，在输入时自动显示的补全提示）。

语法：

kiro-cli inline [SUBCOMMAND] [OPTIONS]
子命令说明
enable开启内联建议
disable关闭内联建议
status显示当前状态
set-customization选择定制化模型
show-customizations显示可用的定制化选项

kiro-cli login ​

使用 Builder ID、Identity Center 或社交账号（Google、GitHub）登录 Kiro CLI。

语法：

kiro-cli login [OPTIONS]
选项说明
--license <TYPE>许可证类型：pro（Identity Center）或 free（Builder ID/Google/GitHub）
--identity-provider <URL>Identity Provider URL（用于 Identity Center）
--region <REGION>AWS 区域（用于 Identity Center）
--social <PROVIDER>社交登录提供商：google 或 github
--use-device-flow强制使用 device flow（适合远程/SSH 环境）

本地环境：自动打开浏览器，在统一认证门户中完成登录。

远程环境（SSH）：自动使用 device flow，显示设备码和 URL，在另一台设备上完成验证。

示例：

bash
# 基本登录（本地打开浏览器，远程显示设备码）
kiro-cli login

# Identity Center 登录
kiro-cli login --license pro --identity-provider https://my-org.awsapps.com/start --region us-east-1

# 社交登录
kiro-cli login --social google

# 强制使用 device flow（适合 SSH 会话）
kiro-cli login --use-device-flow

kiro-cli logout ​

退出 Kiro CLI 服务并清除认证凭据。

清除内容：认证 token、会话凭据、用户 profile 信息

保留内容：Agent 配置、已保存的对话、设置、MCP 服务器配置

bash
kiro-cli logout

注意：注销操作影响全局，所有工作区均生效。

kiro-cli whoami ​

显示当前用户信息及认证状态。

语法：

kiro-cli whoami [OPTIONS]
选项短形式说明
--format-f输出格式：plain、json、json-pretty

示例：

bash
kiro-cli whoami
# Logged in with Builder ID
# Email: user@example.com

kiro-cli whoami --format json-pretty

kiro-cli settings ​

管理 Kiro CLI 配置项。

语法：

kiro-cli settings [SUBCOMMAND] [OPTIONS] [KEY] [VALUE]
参数说明
--delete / -d删除某个配置项
--format / -f输出格式：plain、json、json-pretty
KEY配置项键名（位置参数）
VALUE配置项值（位置参数）
子命令说明
open在默认编辑器中打开配置文件
list列出已配置的项目
list --all列出所有可用配置项及说明

示例：

bash
# 查看所有已配置项
kiro-cli settings list

# 查看所有可用配置项
kiro-cli settings list --all

# 读取某个配置项
kiro-cli settings telemetry.enabled

# 设置配置项
kiro-cli settings telemetry.enabled true

# 删除配置项
kiro-cli settings --delete chat.defaultModel

# 在编辑器中打开配置文件
kiro-cli settings open

kiro-cli diagnostic ​

运行诊断测试，生成系统信息报告，用于排查故障。

语法：

kiro-cli diagnostic [OPTIONS]
选项短形式说明
--format-f输出格式：plain、json、json-pretty（默认 plain）
--force不依赖运行中的 app，独立输出有限诊断信息（速度更快）
  • 不带 --force：需要 Kiro CLI app 正在运行，生成完整诊断报告
  • 带 --force：无需 app 运行，输出内容有限但速度更快

诊断报告包含：系统信息（OS、架构、内存）、Kiro CLI 版本、配置状态、环境变量、已安装依赖、潜在问题。

kiro-cli mcp ​

管理 Model Context Protocol（MCP）服务器。

语法：

kiro-cli mcp [SUBCOMMAND] [OPTIONS]

kiro-cli mcp add — 添加或替换 MCP 服务器

参数说明
--name服务器名称（必填）
--command启动命令（必填）
--scope作用域：workspace 或 global
--env环境变量：key1=value1,key2=value2
--timeout启动超时（毫秒）
--force覆盖已有服务器

kiro-cli mcp remove — 移除 MCP 服务器

kiro-cli mcp list — 列出已配置的 MCP 服务器

bash
kiro-cli mcp list
kiro-cli mcp list workspace
kiro-cli mcp list global

kiro-cli mcp import — 从文件导入服务器配置

kiro-cli mcp status — 查看指定 MCP 服务器的状态

日志文件 ​

Kiro CLI 维护日志文件，用于排查问题：

  • macOS：$TMPDIR/kiro-log/
  • Linux：$XDG_RUNTIME_DIR 或 /tmp/kiro-log/
环境变量取值说明
KIRO_LOG_LEVELerror / warn / info / debug / trace设置日志级别（默认 error）
KIRO_LOG_NO_COLOR1 / true / yes禁用彩色日志输出（v1.26.0+）
bash
# 开启调试日志
export KIRO_LOG_LEVEL=debug
kiro-cli chat

# 适合 CI/CD 的无色输出（v1.26.0+）
export KIRO_LOG_NO_COLOR=1
kiro-cli chat

注意：日志文件可能包含文件路径、代码片段、命令输出等敏感信息，分享时请谨慎。

常见问题 ​

Q：非交互模式（--no-interactive）适合哪些场景？

A：主要用于 CI/CD 流水线和脚本自动化。结合 --trust-all-tools 使用时，Kiro 会直接执行任务、将首条响应输出到 STDOUT 后退出，方便脚本捕获结果或检查退出码。例如：kiro-cli chat --no-interactive --trust-all-tools "Analyze code quality".

Q：--resume、--resume-picker、--resume-id 三种方式有什么区别？

A：--resume 直接恢复当前目录的最近一次会话，适合快速续接；--resume-picker 打开交互式列表，可从历史会话中选择，适合有多个并行项目时；--resume-id 通过唯一 ID 精确指定要恢复的会话，适合脚本或自动化场景。

Q：kiro-cli doctor 和 kiro-cli diagnostic 有什么区别？

A：doctor 侧重于"诊断 + 自动修复"，会尝试修复发现的问题；diagnostic 侧重于"收集报告"，只生成详细的系统诊断报告（包含 OS、版本、环境变量等），适合提交 bug 报告或向支持团队提供信息。

友情链接： 能跑吗 · 打工算 · 车主算 · 开发工具 · 人工不智能

Copyright © 2026 地豆 蜀ICP备2021007188号 | 关于本站 | 隐私政策