pi-kimi-cu

English

面向 Pi 的轻量级 Kimi Computer Use 安装与接入包，跑在 macOS 上，不依赖 Kimi Code。

能做什么

• /kimi-cu：两个入口——检查状态、引导配置
• 安全安装 KimiCU.app：下到临时目录、校验、带回滚替换，再清理现场
• 注册 launchd 后台服务；权限交给官方 KimiCU App 窗口处理
• 可选安装 pi-mcp-adapter
• MCP 接入：引导配置走默认 Pi 路径；需要时可用 /kimi-cu mcp 选其他方式
• 一份接好后给 Pi 用的 KimiCU skill

环境要求

• Apple Silicon Mac
• macOS 14 及以上
• Pi
• Node.js 20+

安装

从 npm：

pi install npm:@specode/pi-kimi-cu

从 git：

pi install git:github.com/specode/pi-kimi-cu

本地目录：

pi install ~/Code/pi-kimi-cu

重启 Pi，然后执行：

/kimi-cu

可用命令：

/kimi-cu status   # 检查状态
/kimi-cu setup    # 引导配置

交互说明

1. 检查状态：平台、App、后台服务、权限、MCP 配置与运行状态。
2. 引导配置：按缺口逐步处理——
   • App 未安装 → 询问是否下载安装
   • 后台服务未运行 → 询问是否注册启动
   • 权限未齐 → 打开 KimiCU App，请你在官方窗口里确认 Accessibility / Screen Recording
   • MCP 未配置 → 询问是否写入默认 Pi MCP 配置
   • MCP 未连接 → 询问是否 /reload

MCP

推荐走 pi-mcp-adapter。引导配置时若缺失会先询问是否安装：

pi install npm:pi-mcp-adapter

需要自定义路径或只看配置片段时：

/kimi-cu mcp

通用片段：

{
  "mcpServers": {
    "kimi-cu": {
      "command": "/Applications/KimiCU.app/Contents/MacOS/kimi-cu",
      "args": ["mcp"]
    }
  }
}

扩展只会迁移它能明确认出的旧版 KimiCU 配置。碰到同名自定义 server、损坏的 JSON，或读不了的文件时会停下来，不会覆盖原内容。

安全说明

App 从 Moonshot AI 官方 CDN 下载。安装前会检查 Bundle ID、arm64 架构、签名 Team ID，并做严格 codesign 校验。签名校验失败时默认中止；只有你在交互提示里明确确认后才会继续。

辅助功能和屏幕录制由官方 KimiCU App 引导授权，本包不会代你拨动系统开关。

开发检查

npm run check

许可证

MIT