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
Что это?Kitter — это десктоп-приложение и CLI для управления 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 там работает стабильно.
Где Kitter хранит мои скиллы и настройки?Всё хранится локально: конфигурация и записи об источниках попадают в каталог данных приложений ОС, а содержимое скиллов — в папку библиотеки (например, '~/Library/Application Support/Kitter/skills' на macOS), которую можно перенести командой 'kitter library --set'.
Что такое Skill в Kitter?Skill — это многократно используемая возможность, которую агент может обнаружить и задействовать; добавить их можно из локальной папки, GitHub, источника, совместимого с skills.sh, или источника плагинов Claude, а Kitter держит по одной поддерживаемой копии на каждый скилл.
Как обновить скиллы сразу во всех моих проектах?Запустите 'Check for updates' в десктоп-приложении или используйте 'kitter check' и 'kitter update' из CLI — поскольку проекты ссылаются на общий источник через управляемые ссылки, а не копии, одно обновление доходит до каждой связанной установки.
Можно ли увидеть, какие скиллы агент реально может использовать прямо сейчас?Да, раздел Projects показывает полный фактический набор скиллов для каждого агента, включая установки, сделанные вне Kitter, их источники и примерную стоимость в токенах/контексте на каждого агента.
Можно ли занести в Kitter скиллы, которые я уже разбросал по проектам?Да — выберите 'Existing installations', чтобы просмотреть и принять уже установленные скиллы, не перемещая и не трогая их исходные каталоги.
What are similar projects?evondevKit, asd-ste100-skill, aichat, leviathan, aos-ce, coral, open-knowledge, pdfcraft
Which topics is it in?package-manager, skills, plugin, claude, agent-skills, rust, command-line-tool, gui, desktop-app, terminal, ai-agents, tool
Creator
what1f
Size
6.6 MB
Stars
306
Updated
CommitOct 17Releasev0.2.0Oct 17
Age
1mo
Commits · 90 Days