what1f/kitter · 上手攻略
- 仓库：what1f/kitter
- 链接：https://github.com/what1f/kitter
- 分类：AI Agent 工具 · Skill 管理
- 作者：Tom
- 更新：2026-09-09
是什么
Kitter 是一个用 Rust + GPUI 构建的轻量级 AI Agent Skills 桌面管理器，附带独立的 CLI。它解决的是"同一套 Skill 在多个项目里各自维护一份副本"这个常见痛点——在项目之间共享链接（managed links）而不是独立副本，一处更新，所有项目同步生效。
概念简单：Library（技能库） → Projects（项目） → Installs（安装实例），三层分离，清晰可见。
解决什么问题
当你同时用 Claude Code、Cursor、Copilot 等多个 Agent 工具，或者在多个项目里分别跑 Agent 时，往往会遇到：
- 同一个 Skill（比如
claude-code或read-file）在每个项目里都有一份拷贝 - Skill 作者更新了，你得手动同步 N 个副本
- 不知道哪个 Agent 实际用的是哪个 Skill 版本
Kitter 的做法是：Skill 内容存在一个统一的 Library 目录，项目通过 managed link 指向它，更新只在源头做，所有引用它的项目自动用新版本。
快速安装
方式一：下载预编译包（推荐）
从 GitHub Releases 下载对应平台：
| 平台 | 下载文件 | 安装方式 |
|---|---|---|
| macOS Apple Silicon | Kitter--desktop-macos-arm64.dmg |
挂载 DMG，拖 Kitter.app 到 Applications |
| macOS Intel | Kitter--desktop-macos-x86_64.dmg |
同上 |
| Windows x64 | Kitter--desktop-windows-x86_64.exe |
直接运行 EXE |
| Linux x64 | Kitter--desktop-linux-x86_64.tar.gz |
解压后运行 ./Kitter |
⚠️ macOS 首次启动被拦截：如果 macOS 提示"无法打开"，去 System Settings → Privacy & Security → Open Anyway 确认，或运行：
bash xattr -dr com.apple.quarantine /Applications/Kitter.app
方式二：独立 CLI（无桌面应用）
# 下载 standalone CLI（macOS/Windows/Linux）
# 从 GitHub Releases 下载对应平台的 kitter 可执行文件，放到 PATH 中
# 通过 skill 安装（用 npx）
npx skills add what1f/kitter --skill kitter
# 或者
npx https://github.com/what1f/kitter --skill kitter
⚠️ 不确定：standalone CLI 包的具体命名格式，建议直接去 Releases 页面查看下载链接中的确切文件名。
方式三：从源码构建
git clone https://github.com/what1f/kitter.git
cd kitter
cargo run --release --locked --features desktop --bin kitter-desktop
- 需要 Rust toolchain（建议
rustup install stable） --features desktop编译桌面 UI；省略则只编译 CLI- Linux 桌面应用尚未在真实系统上完整验证，CLI 相对稳定
核心用法
桌面应用流程
- 启动：打开 Kitter.app
- 添加 Skill 源：点击
+添加 - 本地文件夹 - GitHub 仓库（owner/repository --skill skill-name） - skills.sh 兼容源 - Claude 插件源 - 管理已安装的 Skill：查看每个 Skill 的所有 Installs 标签页，了解哪些项目在用、Agent 能否发现它
- 安装 Skill 到项目：选中 Skill → 选项目 → 安装到
.agents/skills目录或特定 Agent 目录 - 查看项目有效 Skill：Projects 标签页显示每个 Agent 的完整技能链（含项目级、用户级、插件提供的）
- 检查更新：
Check for updates或 CLIkitter check / kitter update
CLI 核心命令
# 添加 Skill 源
kitter add npx https://github.com/owner/repository --skill skill-a
# 安装 Skill 到项目
kitter install skill-a --project /path/to/project --target universal
# 查看项目 Skill 状态
kitter project /path/to/project
# 检查更新
kitter check
kitter update skill-a
# 查看/设置技能库目录
kitter library
kitter library --set /absolute/path
Skill 库默认路径
| 平台 | 默认路径 |
|---|---|
| macOS | ~/Library/Application Support/Kitter/skills |
| Windows | %LOCALAPPDATA%\Kitter\skills |
| Linux | ~/.local/share/Kitter/skills（或 $XDG_DATA_HOME/Kitter/skills） |
典型适用场景
- 多 Agent 项目并行：同时跑 Claude Code + Cursor + 自定义 Agent，每个项目 Skill 组合不同
- Skill 作者维护者：在一个地方更新 Skill，所有引用方自动同步
- 团队 Skill 标准化：团队成员共享统一的 Skill 库和版本策略
- Agent 可解释性调试：通过"Project Effective Skills"视图看清楚每个 Agent 实际能用什么 Skill、上下文消耗多少 Token
坑与注意
| 坑点 | 说明 |
|---|---|
| macOS 未签名 | 首次启动需要手动确认"Open Anyway"，或执行 xattr 命令绕过 |
| Linux 桌面版稳定性 | README 自述桌面构建在真实 Linux 系统上"still needs validation"，生产环境建议先用 CLI |
| 独立 CLI 与 Skill 协同 | 建议通过 npx skills add what1f/kitter --skill kitter 安装 Skill，再由 Skill 引导下载 standalone CLI |
| Windows 路径空格 | CLI 对路径中的空格处理建议用引号包裹 |
| agent-specific 安装 | --target universal vs Agent-specific 目录路径需注意区分，否则 Agent 可能找不到 Skill |
| Skill 冲突 | 如果项目目录已有独立 Skill 副本，Kitter 的 managed link 不会自动接管，需要用"Existing installations"功能手动 Adopt |
与同类对比
| Kitter | skills.sh | 手动管理（复制粘贴） | |
|---|---|---|---|
| 语言 | Rust（GPUI 桌面） | Shell 脚本 | — |
| 视图 | 可视化（桌面 UI） | 命令行 | 无 |
| 更新机制 | managed links，一处更新全同步 | 脚本下载覆盖 | 手动逐个更新 |
| 多 Agent 支持 | ✅ 每个 Agent 可有独立 Skill 集 | 有限 | ❌ |
| Token 消耗预估 | ✅ 界面显示 | ❌ | ❌ |
| 跨平台 | macOS/Windows/Linux | Unix-like | — |
| 安装包大小 | 约 20-30MB（Rust 原生） | 极小 | — |
一句话推荐结论
Kitter 是目前最简洁的多项目 Skill 统一管理方案，Rust 原生桌面 + managed link 机制让 Skill 更新不再需要逐项目手动同步，适合同时跑多个 Agent 项目或维护多个 Skill 集合的开发者。