> 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/commands.md).

# Overview

Run `agmk <command> --help` for the built-in usage of any command. Each page below documents arguments, options, behavior, and exit codes.

| Command                                                              | What it does                                                                              |
| -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| [`agmk init [dir]`](/agmk-docs/command-reference/init.md)            | Scaffold a git-first marketplace (or a standalone plugin with `--plugin`).                |
| [`agmk add <spec> <name>`](/agmk-docs/command-reference/add.md)      | Register a plugin: reference a remote repo, or scaffold from a built-in / local template. |
| [`agmk build`](/agmk-docs/command-reference/build.md)                | Generate the Codex and Cursor registries from the catalog.                                |
| [`agmk sync`](/agmk-docs/command-reference/sync.md)                  | Reconcile `marketplace.json` and the docs with the plugins on disk.                       |
| [`agmk bump [plugin] [level]`](/agmk-docs/command-reference/bump.md) | Bump a plugin's version (conventional-commit aware) and sync everything.                  |
| [`agmk validate`](/agmk-docs/command-reference/validate.md)          | Validate the catalog (local checks + official `claude plugin validate`).                  |
| [`agmk list`](/agmk-docs/command-reference/list.md)                  | List the available plugin templates.                                                      |

## Global options

| Option          | Description                         |
| --------------- | ----------------------------------- |
| `-V, --version` | Print the installed agmk version.   |
| `-h, --help`    | Show help for agmk or a subcommand. |

## Conventions used on these pages

* **Plugin and marketplace names are kebab-case** — lowercase letters, digits, and hyphens (`^[a-z0-9]+(-[a-z0-9]+)*$`).
* Most commands **find the marketplace by walking up** from the current directory to the nearest `.claude-plugin/marketplace.json`, so you can run them from any subfolder.
* Commands that fail set a **non-zero exit code**, making them safe to gate CI on.
* Terminal output uses agmk's neon theme when the terminal supports color, and falls back to plain text under `NO_COLOR` or when piped.