> For the complete documentation index, see [llms.txt](https://agent-marketplace-kit.gitbook.io/agmk-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://agent-marketplace-kit.gitbook.io/agmk-docs/command-reference/sync.md).

# agmk sync

Reconcile `marketplace.json` and the generated docs with the plugins actually on disk. The **source of truth** is each plugin's `.claude-plugin/plugin.json`.

```bash
agmk sync
```

`add` and `bump` run `sync` internally, so you call it directly mainly after **hand-editing a plugin manifest** or moving files around.

## What it does

Scanning every directory under `pluginRoot` that has a `.claude-plugin/plugin.json`, `sync`:

* **adds** catalog entries for plugin directories not yet listed (with a marketplace-root-relative `"./…"` source);
* **updates** any `version`, `description`, `author`, `keywords`, or `homepage` that drifted from the manifest into the catalog;
* **flags orphans** — catalog entries whose local source directory no longer exists (remote `github` / `url` / `git-subdir` sources are left untouched);
* **sorts** plugins by name and writes `marketplace.json`;
* **refreshes** any already-built Codex/Cursor registries;
* **regenerates** the plugin table in `README.md` and the plugin list in `AGENTS.md`, between the `<!-- agmk:plugins:start -->` / `<!-- agmk:plugins:end -->` markers.

{% hint style="info" %}
Drop the same `agmk:plugins` markers into any other Markdown file and `sync` maintains the plugin list there too.
{% endhint %}

## Output & exit code

Prints the list of changes (or *"Catalog already in sync."*). If any **orphan** is detected, it prints a `!` line telling you to remove the entry or restore the plugin, and exits **non-zero**.

## Example

```bash
# after editing plugins/tdd-coach/.claude-plugin/plugin.json
agmk sync
# ~ updated description of "tdd-coach"
# ~ refreshed plugin list in README.md
```

## See also

* [`agmk add`](/agmk-docs/command-reference/add.md) · [`agmk bump`](/agmk-docs/command-reference/bump.md) · [`agmk validate`](/agmk-docs/command-reference/validate.md)
* Reference: [marketplace.json](/agmk-docs/reference/marketplace-json.md)