kitter README

The project's README from github.com/what1f/kitter. As one markdown file: README.md.

Kitter — one skill library where every project gets only what it needs

简体中文

Apache-2.0 license macOS, Windows, and Linux desktop app Built with Rust

One skill library. Every project gets only what it needs.

Kitter is a desktop app and CLI for managing Agent Skills across projects. Keep your skills in one library, install the right combination for each project, and update them in one place.

Built entirely in Rust with GPUI, Kitter pairs a straightforward interface with a small footprint and smooth native performance.

Kitter maintains one skill library and links selected skills to projects and user-level installations

Why Kitter

Working across projects often means maintaining several copies of the same skill and keeping track of what each agent can use. Kitter keeps those connections visible:

Install Kitter

Download the app for your platform from GitHub Releases.

Kitter is not yet signed with an Apple Developer ID. If macOS blocks the first launch, confirm that you downloaded it from the official release, then go to System Settings → Privacy & Security → Open Anyway and follow the prompts. See Apple’s instructions.

You can also run the following command, then open Kitter again:

xattr -dr com.apple.quarantine /Applications/Kitter.app

The desktop app and CLI are separate release artifacts built on the same core. Standalone CLI packages for macOS, Windows, and Linux are available from GitHub Releases. The built-in Kitter skill resolves that standalone CLI and guides you through downloading it when needed.

Manage your skills with Kitter

1. Build one library

Use + to add skills from a local folder, GitHub or a skills.sh-compatible source, or a Claude plugin source. If skills are already scattered across projects, choose Existing installations to inspect and adopt them without moving their source directories.

Kitter keeps one maintained source for each skill. Open its Installs tab to immediately see every project using it, every installation location, and the agents that can discover it.

Kitter skill library showing one managed skill installed across several projects

2. Install only where needed

Select a skill, choose a project, then install it into the shared .agents/skills directory or an agent-specific directory. Kitter creates managed links instead of independent copies, so projects can use different combinations without creating update drift.

Kitter installation dialog for selecting a project and agent targets

Skills you use across all projects can also be installed at the user level.

3. Verify what is actually active

Open Projects to see the complete effective skill set for every agent—not just installations managed by Kitter. The view discovers project, parent, user-level, built-in, and plugin-provided capabilities, then shows where each one came from.

The per-agent token estimate helps you spot skills that add unnecessary context overhead.

Kitter project view showing managed and unmanaged effective skills, plugins, agents, and estimated context cost

4. Update once

Run Check for updates from the desktop app or use kitter check and kitter update. Every managed project continues to use the same maintained source.

The equivalent CLI workflow is intentionally small:

kitter add npx https://github.com/owner/repository --skill skill-a
kitter install skill-a --project /path/to/project --target universal
kitter project /path/to/project
kitter update skill-a

Standalone CLI and agent skill

You do not need the desktop app to use Kitter. Download the standalone CLI from GitHub Releases, put kitter on your PATH, and install the $kitter skill directly:

npx skills add what1f/kitter --skill kitter

The skill lets an agent inspect the current machine, add or adopt skill sources, install the right project combination, and verify the result through the standalone kitter CLI. If the CLI is missing, the skill can guide you through downloading it from an official Release.

Build from source
git clone https://github.com/what1f/kitter.git
cd kitter
cargo run --release --locked --features desktop --bin kitter-desktop

Platform status

Local data

Kitter stores configuration and source records in the operating system's application-data directory. Skill contents live in the library directory:

Platform Default skill library
macOS ~/Library/Application Support/Kitter/skills
Windows %LOCALAPPDATA%\Kitter\skills
Linux $XDG_DATA_HOME/Kitter/skills or ~/.local/share/Kitter/skills

View or change the location with kitter library and kitter library --set /absolute/path.

Contributing

Issues and pull requests are welcome. Please open an issue before starting a large behavioral or UI change so the scope can be aligned first.

If Kitter makes your skill setup calmer, consider starring the repository. It helps more multi-project developers find it.

License

Kitter is available under the Apache License 2.0. Licenses for bundled fonts, icons, and other third-party material are listed in THIRD_PARTY_LICENSES.md.

Star History

Star History Chart

kitter (what1f/kitter)

Searching Database…

306 ·GitHub
这是什么?Kitter 是一个桌面应用和命令行工具,用于管理多个项目中的 Agent Skills:你把技能集中放在一个库中,只为每个项目安装它需要的那部分组合,并能从一个地方统一更新它们。
Kitter 是桌面应用还是命令行工具?两者都是——它以原生桌面应用(用 Rust 和 GPUI 构建)和一个基于同一核心构建的独立 CLI 形式发布,你可以单独使用其中任意一个。
怎么安装 Kitter?从 GitHub Releases 下载对应系统的发行包:macOS .dmg(Apple Silicon 或 Intel)、Windows x64 .exe 或 Linux x64 .tar.gz,然后运行应用,或者解压并运行 './Kitter' 二进制文件。
除了下载的二进制文件,我还需要别的东西吗?不需要——桌面应用和 CLI 都是自包含的;如果只用 CLI,只需把 'kitter' 二进制文件放进 PATH,并安装内置的 $kitter 技能。
Kitter 在每个平台上都一样吗?还不完全一样——macOS 构建没有用 Apple Developer ID 签名,Gatekeeper 可能会拦截首次启动;Linux 上的 CLI 虽然稳定,但 Linux 桌面应用“仍需要在真实系统上验证”。
Kitter 把我的技能和设置存在哪里?一切都保留在本地:配置和来源记录存放在系统的应用数据目录中,技能内容则存放在一个库文件夹里(例如 macOS 上的 '~/Library/Application Support/Kitter/skills'),你可以用 'kitter library --set' 重新指定它的位置。
在 Kitter 里,Skill 到底是什么?Skill 是智能体可以发现并使用的可复用能力;你可以从本地文件夹、GitHub、兼容 skills.sh 的来源或 Claude 插件来源添加技能,Kitter 会为每个技能保留一份统一维护的副本。
怎么一次性更新所有项目里的技能?在桌面应用中运行 'Check for updates',或在命令行使用 'kitter check' 和 'kitter update'——由于项目是通过托管链接而非复制的方式关联到共享来源的,一次更新就能覆盖每一个已链接的安装。
我能看到智能体现在实际能用哪些技能吗?可以,Projects 视图会显示每个智能体的完整有效技能集,包括在 Kitter 之外安装的技能、它们的来源,以及每个智能体的 token/上下文开销估算。
我能把已经散落在各项目里的技能收进 Kitter 吗?可以——选择 'Existing installations' 即可检查并接管已安装的技能,而不必移动或改动它们原来的源目录。
Creator
what1f
Size
8.7 MB
Stars
306
Age
1mo
Commits · 90 Days