FAQ

When you need this: You have a quick "what happens if…" question about syncing skills or MCPs.

Will Kasetto Overwrite My MCP Entries?

No. MCP merges are additive and existing server entries are never overwritten. See How Sync Works.

What Happens When Two Sources Define The Same MCP Server Name?

First write wins based on config order. Later sources with the same server name are skipped. See How Sync Works.

Where Is The Lock File?

• Global scope: $XDG_DATA_HOME/kasetto/kasetto.lock (default: ~/.local/share/kasetto/kasetto.lock)
• Project scope: ./kasetto.lock

See How Sync Works.

Should I Commit kasetto.lock?

Yes. For project scope, commit both kasetto.yaml and kasetto.lock, just like you'd commit Cargo.lock or package-lock.json. The config says what you want; the lock pins exactly which versions everyone gets. The lock is deterministic and portable (relative paths, no timestamps), so it diffs cleanly. Machine-local runtime state lives in the cache dir and is never committed. See How Sync Works → The Lockfile Contract.

How Do I Update Pinned Versions?

Run kst sync --update (alias -u) to re-resolve branch / default-HEAD sources and rewrite the pins. A plain kst sync honors the lock and won't fetch when destinations already match. Use kst sync --update <name> to update only selected entries. See How Sync Works → How sync Honors the Lock.

How Do I Uninstall Safely?

• To remove tracked installs for a scope: kst clean
• To remove everything including the binary: kst self uninstall

See kst clean and kst self uninstall in Commands.

Can I Use Multiple Agents?

Yes. Set agent to a list. See Configuration.

Does Kasetto Run Code From Skills?

No. Skills are copied as directories. Execution is up to the agent you load them into.

Can I Pin Sources To A Known-Good Version?

Yes. Use ref: with a tag or commit SHA. See Cookbook.

What Does --dry-run Do?

It prints what would change without writing any files. Useful in CI. See CI & automation.

Why Didn't My MCP Servers Show Up?

Most common causes:

• The target agent settings file is malformed JSON/TOML
• The MCP file doesn't contain a top-level mcpServers object

See How Sync Works (corrupted settings file behavior).

How Do Remote Configs (--config https://...) Authenticate?

Kasetto selects tokens by the URL hostname using the same rules as skill/MCP sources. See Authentication.