docs(catalog): document the update path - autoUpdate is off by default

`claude plugin marketplace add` records no `autoUpdate` key, and Claude Code
only defaults it on for Anthropic's own catalogs. A release published here
therefore never reaches an already-registered machine on its own.

Adds a "Staying up to date" section after Install with the manual commands
(`claude plugin marketplace update`, `claude plugin update`) and a paste-ready
`extraKnownMarketplaces` settings block that turns auto-update on.

Measured on Claude Code 2.1.260 in an isolated CLAUDE_CONFIG_DIR profile:
- `marketplace add` writes {source:{source,url}} with no autoUpdate
- `autoUpdate: true` in extraKnownMarketplaces propagates to
  plugins/known_marketplaces.json on next start
- negative control: `false` propagates too, so the probe discriminates

One place only; the 12 plugin READMEs are untouched.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-09-04 18:42:21 +02:00
commit ca19723bcb

View file

@ -16,6 +16,42 @@ Then open Claude Code and type `/plugin` to browse and install — the command a
Each plugin keeps its own full README and CHANGELOG; this page is just the catalog.
## Staying up to date
Auto-update is **off** by default for this marketplace. `claude plugin marketplace add` records no
`autoUpdate` key, and Claude Code only defaults it on for Anthropic's own catalogs — so a release
published here does not reach an already-registered machine on its own.
Pull updates by hand:
```bash
claude plugin marketplace update ktg-plugin-marketplace # refresh the catalog
claude plugin update <plugin> # update one installed plugin (restart to apply)
```
Or turn auto-update on once, by declaring the marketplace in your user settings
(`~/.claude/settings.json`). This is the entry `marketplace add` already writes, plus `autoUpdate`:
```json
{
"extraKnownMarketplaces": {
"ktg-plugin-marketplace": {
"source": {
"source": "git",
"url": "https://git.fromaitochitta.com/open/ktg-plugin-marketplace.git"
},
"autoUpdate": true
}
}
}
```
Claude Code then refreshes this marketplace and its installed plugins on startup.
Measured on Claude Code 2.1.260 in an isolated `CLAUDE_CONFIG_DIR` profile: a fresh
`marketplace add` writes the entry above *without* `autoUpdate`; setting the key to `true`
propagates to `plugins/known_marketplaces.json` on the next start, and `false` propagates too.
## Non-goals
- **Not a host for plugin source or issues.** This repository holds the marketplace manifest and this catalog page. Code, issues and releases live in each plugin's own repository, linked from its entry below.