kasetto
πΌ Declarative AI agent environment manager, written in Rust
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/pivoshenko/kasetto with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/pivoshenko/kasetto'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/pivoshenko--kasetto)HTML
<a href="/listings/pivoshenko--kasetto"><img src="/api/listings/pivoshenko--kasetto/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
Standalone Installer
**macOS and Linux:**
curl -fsSL kasetto.dev/install | sh
**Windows:**
powershell -ExecutionPolicy Bypass -c "irm kasetto.dev/install.ps1 | iex"
Homebrew
brew tap pivoshenko/tap brew trust pivoshenko/tap brew install kasetto
Scoop (Windows)
scoop bucket add kasetto https://github.com/pivoshenko/scoop-bucket scoop install kasetto
Cargo
cargo install kasetto
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md Β· README Β· 310 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <p align="center">
- <a href="https://kasetto.dev/">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/pivoshenko/kasetto/main/assets/preview_social_dark.svg" />
- <img alt="Kasetto - a declarative AI agent environment manager, written in Rust" src="https://raw.githubusercontent.com/pivoshenko/kasetto/main/assets/preview_social_light.svg" width="800" />
- </picture>
- </a>
- </p>
- <p align="center">
- <a href="https://github.com/pivoshenko/kasetto/actions/workflows/ci.yaml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/pivoshenko/kasetto/ci.yaml?style=flat-square&logo=github&logoColor=white&label=CI&color=0A6847"></a>
- <a href="https://github.com/pivoshenko/kasetto/releases"><img alt="Release" src="https://img.shields.io/github/v/release/pivoshenko/kasetto?style=flat-square&logo=github&logoColor=white&color=4856CD&label=Release"></a>
- <img alt="Rust" src="https://img.shields.io/badge/Rust-Stable-F74C00?style=flat-square&logo=rust&logoColor=white">
- <a href="https://github.com/pivoshenko/kasetto/blob/main/LICENSE-MIT"><img alt="License" src="https://img.shields.io/badge/License-MIT%20%7C%20Apache--2.0-0A6847?style=flat-square&logo=opensourceinitiative&logoColor=white"></a>
- <a href="https://stand-with-ukraine.pp.ua"><img alt="Stand with Ukraine" src="https://img.shields.io/badge/Stand_With-Ukraine-FFD700?style=flat-square&labelColor=0057B7"></a>
- </p>
- <p align="center">
- <a href="https://backlinklog.com/listing/kasetto.dev?utm_source=backlinklog&utm_medium=badge"><img alt="Listed on BacklinkLog" src="https://backlinklog.com/badge/kasetto.dev.svg" width="160" height="40"></a>
- </p>
- **About the name**
- Name comes from the Japanese word **γ«γ»γγ** (*kasetto*) - cassette. Think of Skills, MCPs, commands, subagents, instructions, and plugins as cassettes you plug in, swap out, and share across machines.
- <a href="https://twitter.com/yachima_tana/status/1647153787923234816"><img width="24" alt="Kasane Teto, artwork by yachima tana" src="https://static.zerochan.net/Kasane.Teto.1024.4077055.webp"></a> Someone commented under a Reddit post about Kasetto that the name also reminded them of **Kasane Teto** (ιι³γγ), the virtual singer. That turns out to fit the project just as well, so both origins are canon and Teto is the patron saint of Kasetto.
- ## Why Kasetto
- There are good tools in this space already. [Vercel Skills](https://github.com/vercel-labs/skills) installs skills from a curated catalog, and [Claude Plugins](https://claude.com/plugins) offer runtime integrations. Both work well for one-off installs, but neither gives you a declarative, version-controlled config. See [Kasetto vs the alternatives](https://kasetto.dev/docs/vs-alternatives) for the full comparison.
- Kasetto is a **community-first** project that solves a different problem: **declarative, reproducible AI environment management across projects, machines, and agents.**
- - **Declarative**: skills, commands, subagents, MCPs, instructions, plugins, and agents in one YAML file. Apply globally or scope to a project; configs compose with `extends`, so org, team, and project stay in sync
- - **Enterprise & private repositories**: pull from GitHub, GitLab, Bitbucket, Codeberg, Gitea, and self-hosted instances, public or private. Onboard a new engineer with one command; everyone gets the same environment, zero drift
- - **Agent-agnostic**: use Claude Code, Cursor, Codex, Windsurf, Copilot, Gemini CLI, or [any supported agent](#supported-agents), and switch without rebuilding your setup. The environment belongs to you and your team, not to one editor
- - **Skills, Commands, Subagents, MCPs & Instructions**: five asset kinds from one source, instruction files and subagents included (`CLAUDE.md`, `.cursor/rules`, `AGENTS.md`, `.claude/agents`, ...). Everything is transformed into each agent's native format, and auto-merged. Distribute instructions, tools, and prompts by sharing a repository link
- - **Plugins**: enable plugins from any Claude Code plugin marketplace in Claude Code and Copilot CLI. Kasetto copies no plugin files: it declares the marketplace and enables the plugin in the tool's settings, the tool installs it itself, and the lock records exactly what Kasetto wrote
- - **Secrets management**: put `${kst_...}` placeholders in your configs instead of real tokens. At sync time Kasetto pulls the value from your environment, a credentials file, or a secret manager you already use (1Password, Vault, AWS, GCP, Azure, KeePassXC, pass, macOS Keychain) and injects it into the agent's settings only
- - **Speed**: built in Rust. It hashes content and diffs a lock file so only what changed gets touched, and full syncs finish in seconds
- - **Universal**: one static binary for macOS, Linux, and Windows. Install as `kasetto`, run as `kst`. CI-friendly with `--json` output and real exit codes
- > Inspired by [cargo](https://github.com/rust-lang/cargo) and [uv](https://github.com/astral-sh/uv): the same lock-first, declarative, CLI-only ergonomics, applied to AI agent skills.
- ## Install
- ### Standalone Installer
- **macOS and Linux:**
- ```bash
- curl -fsSL kasetto.dev/install | sh
- ```
- **Windows:**
- ```powershell
- powershell -ExecutionPolicy Bypass -c "irm kasetto.dev/install.ps1 | iex"
- ```
- ### Homebrew
- ```bash
- brew tap pivoshenko/tap
- brew trust pivoshenko/tap
- brew install kasetto
- ```
- ### Scoop (Windows)
- ```bash
- scoop bucket add kasetto https://github.com/pivoshenko/scoop-bucket
- scoop install kasetto
- ```
- ### Cargo
- ```bash
- cargo install kasetto
- ```
- ## Getting Started
- **1. Scaffold a config:**
- ```bash
- kst init # creates ./kasetto.yaml in the current directory
- kst init --global # or a global one at ~/.config/kasetto/kasetto.yaml
- ```
- Edit the generated `kasetto.yaml`: pick an `agent`, add a `skills:` source, and you're ready to sync. Or let Kasetto edit the config for you:
- ```bash
- kst add https://github.com/anthropics/skills # add every skill in the pack
- kst add https://github.com/anthropics/skills@v1.2.0 # `@<ref>` shorthand (cargo/uv-style)
- kst add https://github.com/anthropics/skills --skill pptx # or just named ones
- kst add https://github.com/example/repo --skill find --mcp github --command review
- ```
- `kst add` appends the source (keeping your comments) and syncs it in one step; `kst remove <source>` reverses it. See [cargo/uv-style editing](#commands) below.
- **2. Sync skills into your agents:**
- ```bash
- # uses ./kasetto.yaml in the current directory
- kst sync
- # or point at a shared team config over HTTPS
- kst sync --config https://example.com/team-skills.yaml
- ```
- Want bare `kst sync` to always pull from a remote URL? Persist it in `~/.config/kasetto/config.yaml`:
- ```yaml
- source: https://github.com/pivoshenko/pivoshenko.ai/blob/main/kasetto.yaml
- ```
- After that, `kst sync` resolves the URL automatically. No `--config` flag needed.
- That's it. Kasetto pulls the skills, installs them into the right agent directory, and records exactly what it installed in `kasetto.lock`. Commit `kasetto.yaml` and `kasetto.lock` together (like `Cargo.lock` or `package-lock.json`) and every teammate gets identical versions. A plain `kst sync` honors the lock without re-resolving moving refs; `kst sync --update` rolls versions forward; `kst sync --locked` enforces the lock in CI.
- See [pivoshenko/pivoshenko.ai](https://github.com/pivoshenko/pivoshenko.ai) for a community example pulling skills from multiple packs for Claude Code and OpenCode.
- **3. See what's installed:**
- ```bash
- kst list # table of installed skills, MCPs, commands, instructions, subagents, plugins
- kst list --type skills # filter to one asset kind
- kst doctor # version, paths, last sync status
- ```
- ## Commands
- | Command | What it does |
- | ------------------------- | ----------------------------------------------------------------------------------- |
- | `kst init` | Generate a starter `kasetto.yaml` (local, or `--global`) |
- | `kst add <source>` | Append a source to the config and sync it in |
- | `kst remove <source>` | Drop entries from the config and prune the now-unconfigured assets (alias `rm`) |
- | `kst lock` | Re-resolve every source and pin it into `kasetto.lock` without installing |
- | `kst sync` | Install skills, MCPs, commands, subagents, and instructions, enable plugins, honoring the lock |
- | `kst list` | Print a table of installed assets from the lock file |
- | `kst audit` | Security verdicts for installed skills (skills.sh) and MCPs (OSV, deps.dev) |
- | `kst doctor` | Local diagnostics: version, paths, last sync status, broken skills |
- | `kst clean` | Remove tracked assets of every kind for a scope; clear caches |
- | `kst self update` | Fetch the latest release, verify SHA256, replace the binary in place |
- | `kst self uninstall` | Remove installed assets, data, and the binary |
- | `kst completions <shell>` | Emit a shell completion script (`bash`/`zsh`/`fish`/`powershell`) |
- Most commands accept `--json`, `--color <auto|always|never>`, `-q`/`--quiet` (repeat for stricter
- silence), and `--project | --global`. `--plain` is still accepted as a deprecated alias for `--color
- never`.
- Full flags and examples in the [commands reference](https://kasetto.dev/docs/commands).
- ## Configuration
- When `--config` is omitted, Kasetto looks for config in this order:
- 1. `$KASETTO_CONFIG` env var
- 2. `./kasetto.yaml`
- 3. `source:` key in `$XDG_CONFIG_HOME/kasetto/config.yaml`
- 4. `$XDG_CONFIG_HOME/kasetto/kasetto.yaml` (or `~/.config/kasetto/kasetto.yaml`)
- Run `kst init` to scaffold a local config, or `kst init --global` for the global one.
- <!-- kasetto-config:start -->
- ```yaml
- agent:
- - codex
- - claude-code
- skills:
- - source: https://github.com/vercel-labs/next-skills
- skills: "*"
- - source: https://github.com/anthropics/skills
- skills:
- - doc-coauthoring
- - frontend-design
- - pptx
- - source: https://github.com/mattpocock/skills
- sub-dir: skills/productivity
- skills:
- - grill-me
- - caveman
- - source: https://github.com/mattpocock/skills
- skills:
- - name: improve-codebase-architecture
- path: skills/engineering
- commands:
- - source: https://github.com/gsd-build/get-shit-done
- commands:
- - gsd:explore
- - gsd:fast
- agents:
- - source: https://github.com/cursor/plugins
- sub-dir: harness/pstack/claude-code
- agents:
- - poteto-agent
- - comment-sicko
- instructions:
- - source: https://github.com/pivoshenko/pivoshenko.ai
- instructions:
- - docs-autoupdate
- - multi-agent-dispatch
- mcps:
- - source: https://github.com/pivoshenko/pivoshenko.ai
- branch: main
- mcps:
- - github
- - vercel
- - kaggle
- plugins:
- - source: https://github.com/cursor/plugins
- plugins:
- - pstack
- ```
- <!-- kasetto-config:end -->
- Full key reference, merge rules, and `extends:` inheritance live in the [configuration docs](https://kasetto.dev/docs/configuration).
- ### Secrets
- MCP packs often need a token or password. Reference one with a `${kst_<name>}` placeholder instead of committing it. Kasetto resolves it at sync time and writes the value into the agent's settings file only:
- ```json
- {
- "mcpServers": {
- "vercel": {
- "url": "https://mcp.vercel.com",
- "type": "http",
- "headers": { "Authorization": "Bearer ${kst_vercel_token}" }
- }
- }
- }
- ```
- Values come from environment variables first (the name as written, then uppercased, so `${kst_vercel_token}` reads `KST_VERCEL_TOKEN`), then `~/.config/kasetto/credentials.yaml` (`__` in a name descends nested keys, e.g. `${kst_vercel__token}` -> `vercel.token`).
- To pin exactly one source, use the tagged form `${kst:<source>:<ref>}`:
- - **`env`**: specific environment variable
- - **`crd`**: credentials file
- - **`op`**: 1Password
- - **`vault`**: HashiCorp Vault
- - **`kp`**: KeePassXC
- - **`aws`**: AWS Secrets Manager
- - **`gcp`**: Google Secret Manager
- - **`az`**: Azure Key Vault
- - **`pass`**: Pass / GoPass
- - **`keychain`**: macOS Keychain
- Each external manager inherits your existing CLI session, so Kasetto stores no tokens of its own. A missing secret fails the sync (exit non-zero) unless you pass `--allow-missing-secrets`. The resolved value never lands in `kasetto.lock`, so the lock stays commit-safe. Rotated a secret? A plain `sync` won't touch the live entry, so run `kst sync --update` to push it. Full details in the [secret-injection docs](https://kasetto.dev/docs/secrets).
- ## Supported Agents
- Set the `agent` field and Kasetto figures out where to put things.
- <details>
- <summary>Full list of supported agents</summary>
- <br />
- | Agent | Config value | Install path |
- | -------------- | ---------------- | ------------------------------- |
- | Amp | `amp` | `~/.config/agents/skills/` |
- | Antigravity | `antigravity` | `~/.gemini/antigravity/skills/` |
- | Augment | `augment` | `~/.augment/skills/` |
- | Claude Code | `claude-code` | `~/.claude/skills/` |
- | Cline | `cline` | `~/.agents/skills/` |
- | Codex | `codex` | `~/.agents/skills/` |
- | Continue | `continue` | `~/.continue/skills/` |
- | Cursor | `cursor` | `~/.cursor/skills/` |
- | Gemini CLI | `gemini-cli` | `~/.gemini/skills/` |
- | GitHub Copilot | `github-copilot` | `~/.copilot/skills/` |
- | Goose | `goose` | `~/.config/goose/skills/` |
- | Junie | `junie` | `~/.junie/skills/` |
- | Kiro CLI | `kiro-cli` | `~/.kiro/skills/` |
- | OpenClaw | `openclaw` | `~/.openclaw/skills/` |
- | OpenCode | `opencode` | `~/.config/opencode/skills/` |
- | OpenHands | `openhands` | `~/.openhands/skills/` |
- | Pi | `pi` | `~/.pi/agent/skills/` |
- | Replit | `replit` | `~/.config/agents/skills/` |
- | Roo Code | `roo` | `~/.roo/skills/` |
- | Trae | `trae` | `~/.trae/skills/` |
- | Warp | `warp` | `~/.agents/skills/` |
- | Windsurf | `windsurf` | `~/.codeium/windsurf/skills/` |
- | ZCode | `zcode` | `~/.zcode/skills/` |
- </details>
- Pi's preset syncs skills, prompt templates, `AGENTS.md`, and MCPs (`~/.pi/agent/mcp.json`
- globally, `.pi/mcp.json` per project).
- Subagents install into 14 of these agents, in each one's own format; see the [subagents docs](https://kasetto.dev/docs/subagents) for the per-agent table. Plugins are enabled only in Claude Code and GitHub Copilot CLI, the two that install marketplace plugins from their settings; see the [plugins docs](https://kasetto.dev/docs/plugins).
- Don't see your agent? Use the `destination` field to point at any path.
- ## Private Repositories & Enterprise
- Private GitHub, GitLab, Bitbucket, Codeberg, Gitea, and self-hosted instances work via env-var tokens (`GITHUB_TOKEN`, `GITLAB_TOKEN`, `BITBUCKET_TOKEN`, `GITEA_TOKEN`, etc.). No login command, no credentials file. The same tokens apply to remote `--config` and `extends` URLs. Self-hosted Gitea and Forgejo instances named `gitea.*` or `forgejo.*` use `GITEA_TOKEN`.
- Full host table and auth resolution rules in the [authentication docs](https://kasetto.dev/docs/authentication).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itβs helped, pass it on.