kasetto 1.0.0

Name comes from the Japanese word カセット (kasetto) - cassette. Think of skill sources as cassettes you plug in, swap out, and share across machines.

Highlights

• Declarative - one YAML config describes your entire skill setup. Version it, share it, bootstrap a whole team in seconds.
• Syncs skills from GitHub repos or local directories into any agent environment.
• 35+ built-in agent presets: Claude Code, Cursor, Codex, Windsurf, Copilot, Gemini CLI, and many more.
• Tracks every install in a local SQLite manifest - knows what changed and why.
• --dry-run, --json, and --verbose flags for scripting and CI.
• Ships as a single binary - install as kasetto, run as kst.

Why Kasetto

There are good tools in this space already - Vercel Skills installs skills from a curated catalog, and Claude Plugins offer runtime integrations. Both work well for one-off installs, but neither gives you a declarative, version-controlled config.

Kasetto is a community-first project that solves a different problem: declarative, reproducible skill management across machines and agents.

• Team consistency - commit a YAML file, everyone gets the same skills.
• Multi-source - pull from multiple GitHub repos and local folders in one config.
• Agent-agnostic - one config field switches between 35+ agent environments.
• Manifest-backed - every install is tracked, diffable, and inspectable.
• CI-friendly - --json output and non-zero exit codes for automation.

Inspired by uv - what uv did for Python packages, Kasetto aims to do for AI skills.

Install

Standalone installer

macOS and Linux:

curl -fsSL https://raw.githubusercontent.com/pivoshenko/kasetto/main/scripts/install.sh | sh

Windows:

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/pivoshenko/kasetto/main/scripts/install.ps1 | iex"

By default the binary is placed in ~/.local/bin. You can override this with environment variables:

Homebrew

brew install pivoshenko/tap/kasetto

Cargo

cargo install kasetto

From source

git clone https://github.com/pivoshenko/kasetto && cd kasetto
cargo install --path .

Getting started

1. Sync from a shared config or a local file:

# from a remote URL (great for teams)
kst sync --config https://example.com/team-skills.yaml

# from a local file
kst sync --config skills.config.yaml

That's it. Kasetto reads the config, pulls the skills, and installs them into the right agent directory. Next time you run sync, only changed skills are updated.

2. Explore what's installed:

kst list      # interactive browser with vim-style navigation
kst doctor    # version, paths, last sync status

Commands

kst sync

Reads the config, discovers skills, and makes the local destination match.

kst sync [--config <path-or-url>] [--dry-run] [--quiet] [--json] [--plain] [--verbose]

Missing skills are reported as broken but don't stop the run. The exit code is non-zero only for source-level failures.

kst list

Shows everything currently tracked in the manifest.

kst list [--json]

In a terminal it opens an interactive browser - navigate with j/k, scroll with PgUp/PgDn, jump with gg/G. Set NO_TUI=1 or pipe the output to get plain text instead.

kst doctor

Prints local diagnostics: version, manifest DB path, installation paths, last sync time, and any failed skills from the latest run.

kst doctor [--json]

kst self-update

Checks GitHub for the latest release and replaces the current binary in-place.

kst self-update [--json]

Configuration

Pass a config via --config or let Kasetto pick up skills.config.yaml in the current directory.

# Choose an agent preset...
agent: codex

# ...or set an explicit path (overrides agent)
# destination: ./my-skills

skills:
  # Pull specific skills from a GitHub repo
  - source: https://github.com/org/skill-pack
    branch: main
    skills:
      - code-reviewer
      - name: design-system

  # Sync everything from a local folder
  - source: ~/Development/my-skills
    skills: "*"

  # Override the subdirectory inside a repo
  - source: https://github.com/acme/monorepo
    skills:
      - name: custom-skill
        path: tools/skills

Supported agents

Set the agent field and Kasetto handles the rest.

claude is accepted as a legacy alias for claude-code.

Need an agent that isn't listed? Use the destination field to point at any path.

How it works

Kasetto keeps a SQLite database at ~/.kst/manifest.db to track what's installed.

On every sync, it:

1. Reads your config (local file or remote URL)
2. Resolves the destination from the agent preset or explicit path
3. Downloads sources (GitHub tarball) or reads local directories
4. Compares SHA-256 hashes against the manifest to find what changed
5. Installs new skills, updates changed ones, removes skills no longer in the config
6. Saves a sync report you can inspect later with doctor

Only changed files are written. Runs are atomic - if a single skill fails, the rest still sync.

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

Licensed under either MIT or Apache-2.0, at your option.