Kilo CLI 使用说明

Posted on Mar 28, 2026

这份文档基于 Kilo 官方 CLI 文档整理，适合本机 show-help 速查。

它是什么

Kilo CLI 是一个终端里的 coding agent。
官方定位是键盘优先的 TUI / CLI，支持规划、调试、编码、会话管理和 MCP。
当前文档明确适用于 1.0 及以后版本。

官方安装与升级

安装

npm install -g @kilocode/cli

升级

kilo upgrade
npm update -g @kilocode/cli

验证

kilo --version
kilo --help

老 CPU 注意

官方说明里提到，没有 AVX 的旧 CPU 可能会遇到 Illegal instruction，这种情况下建议从 GitHub Releases 下载 -baseline 变体直接运行。

启动方式

TUI

kilo
kilo /path/to/project

非交互

kilo run "Explain how this repo is structured"

Headless / Web / Attach

kilo serve
kilo web
kilo attach <http://localhost:4096>

首次使用

安装后进入项目目录运行：

kilo

首次配置 provider，官方建议用：

/connect

这是交互式添加 provider 凭据的主入口。

常用 CLI 命令

kilo
kilo run [message..]
kilo attach <url>
kilo serve
kilo web
kilo auth
kilo agent
kilo mcp
kilo models [provider]
kilo stats
kilo session
kilo export [sessionID]
kilo import <file>
kilo upgrade [target]
kilo uninstall
kilo pr <number>
kilo github
kilo debug
kilo completion

常用 Slash Commands

会话

/sessions
/resume
/continue
/new
/clear
/share
/rename
/timeline
/fork
/compact
/undo
/redo

Agent / Model / MCP

/models
/agents
/mcps
/connect

系统

/status
/themes
/help
/editor
/exit

内置辅助

/init
/local-review
/local-review-uncommitted

配置文件

MCP 文档页当前推荐的配置文件是：

~/.config/kilo/kilo.json
~/.config/kilo/kilo.jsonc
kilo.json
.kilo/kilo.json

官方 CLI 页还提到过：

~/.config/kilo/opencode.json
~/.config/kilo/opencode.jsonc

所以如果你在旧配置里看到 opencode.json，不奇怪；但新写法建议优先用 kilo.json。

MCP

Kilo 官方明确支持 CLI 内 MCP。

常用命令：

kilo mcp add
kilo mcp list
kilo mcp auth

配置放在 mcp 键下，结构和 OpenCode 很接近：

{
  "$schema": "<https://kilo.ai/config.json>",
  "mcp": {
    "context7": {
      "type": "remote",
      "url": "<https://mcp.context7.com/mcp>",
      "enabled": true
    },
    "memory": {
      "type": "local",
      "command": ["npx", "-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

权限

Kilo 的 permission 配置支持三种动作：

allow
ask
deny

可按工具和模式匹配规则细分，例如：

bash
edit