CLI

keon 是面向 Kisenon 平台的、与 neonctl 形态一致的即插即用客户端。

在 macOS / Linux 上安装

curl -fsSL https://kisenon.com/install.sh | bash

检测您的平台，下载匹配的 keon-<os>-<arch> 二进制文件，对照 /dl/latest/manifest.json 校验 sha256，并安装到 /usr/local/bin（或 ~/.local/bin）。

在 Windows 上安装（PowerShell）

iwr -useb https://kisenon.com/install.ps1 | iex

首次登录

keon login
keon whoami

keon login 运行一个回环 OAuth 流程 —— 无需粘贴密钥。它在一个随机端口上启动一个本地监听器，在您的浏览器中打开控制台的授权页面，并等待重定向。在您授权之后，CLI 在 POST /v1/cli/exchange 处用一次性 code 兑换一个长期的、带 nsk_ 前缀的 API 密钥，作用域限定到您的活跃组织。

该密钥以模式 0600 持久化到 ~/.config/keon/credentials.json。 CLI 只保留最终得到的密钥 —— 绝不保留 OAuth code、state，或任何提供方令牌。keon logout 会在服务器侧撤销该密钥并移除文件；您也可以随时从设置 → API 密钥撤销它。参见身份验证了解完整流程。

常用命令

keon projects list
keon branches list --project <id>
keon connection-string <branch> --project <id>

输出格式

默认是 JSON。要表格形式：keon config set output table，或对每条命令传入 --output table。

安装 Claude skill

keon install --skills

将一个 SKILL.md 加参考文档放入 ./.claude/skills/keon/，这样一个 Claude agent 无需一次设置回合就能驱动 CLI。

故障排查

macOS："developer cannot be verified"

只在二进制文件是通过设置了 Gatekeeper 属性的浏览器下载时发生。去掉它：

xattr -d com.apple.quarantine $(which keon)

Windows：SmartScreen 警告

点击 "More info" → "Run anyway"。每台机器一次。未来的版本可能会对二进制文件签名；v0.1 中没有。

提交 bug

github.com/Seiraiyu/seiraiyu-neon/issues

On this page