> For the complete documentation index, see [llms.txt](https://agent-marketplace-kit.gitbook.io/agkit-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/agkit-docs/readme.md).

# Introduction

<figure><img src="/files/g9N5dON3X0tcviS1ELgH" alt="agkit — the isometric monolith logo" width="150"><figcaption></figcaption></figure>

**agkit** — *AGent marketplace KIT* — is a command-line tool that scaffolds and maintains **plugin marketplaces** for AI coding agents. You keep **one canonical catalog**, agkit derives everything else from it, and you distribute the whole thing with a plain `git push` to **any** forge — GitHub, GitLab, Bitbucket, Gitea, or a self-hosted server.

[![npm version](https://img.shields.io/npm/v/agkit?color=6366f1\&logo=npm\&logoColor=white\&label=agkit)](https://www.npmjs.com/package/agkit) [![npm downloads](https://img.shields.io/npm/dm/agkit?color=a855f7\&logo=npm\&logoColor=white)](https://www.npmjs.com/package/agkit) [![Node.js](https://img.shields.io/node/v/agkit?color=339933\&logo=node.js\&logoColor=white)](https://nodejs.org) [![License: MIT](https://img.shields.io/badge/License-MIT-ec4899.svg)](https://github.com/AGent-marketplace-KIT/cli/blob/main/LICENSE/README.md)

🌐 **Website:** [agent-marketplace-kit.github.io](https://agent-marketplace-kit.github.io/) · 🐙 **Source:** [github.com/AGent-marketplace-KIT/cli](https://github.com/AGent-marketplace-KIT/cli)

Think of it as **`ng` for Angular, but for agent plugin marketplaces**: `init` gives you a push-ready repository, and `add` / `build` / `sync` / `bump` / `validate` cover the whole life of the project afterwards.

> agkit is an unofficial community tool, not affiliated with Anthropic, GitHub, OpenAI, or Cursor.

## What it does

* 🧩 **Multi-agent** — one repository serves Claude Code, GitHub Copilot, OpenAI Codex, and Cursor.
* 🌐 **Forge-agnostic** — distribute via any Git host with a plain `git push`.
* 📁 **One source of truth** — a single `.claude-plugin/marketplace.json`; generated registries derive from it and never drift.
* 🔁 **Full lifecycle** — `init`, `add`, `build`, `sync`, `bump`, `validate`, `list`.
* 🔗 **Reference, vendor, or scaffold** — catalog a remote plugin *by reference* (no clone), *vendor* a template into your repo, or *scaffold* from a built-in template.
* ✅ **CI-ready** — generated GitHub Actions / GitLab CI with `validate` + `build --check` gates.

## How the pieces fit

```
agkit init · add · bump · sync
        │
        ▼
.claude-plugin/marketplace.json   ← the canonical catalog
      + plugins/<name>/
        │
        ├─ read as-is ─────────────►  Claude Code · GitHub Copilot   (native)
        │
        └─ agkit build ────────────►  OpenAI Codex · Cursor          (generated registry)
                                          │
                                          ▼
                                    git push → any forge → consumers install
```

* **Native agents** (Claude Code, GitHub Copilot) read the catalog directly — push the repo and it installs.
* **Generated-registry agents** (Codex, Cursor) install from their own committed registry, which `agkit build` derives from the same catalog.

## Where to go next

| I want to…                                       | Start here                                                     |
| ------------------------------------------------ | -------------------------------------------------------------- |
| Install the CLI                                  | [Installation](/agkit-docs/getting-started/installation.md)    |
| Ship my first marketplace in four steps          | [Quick start](/agkit-docs/getting-started/quickstart.md)       |
| Understand the catalog, plugins, and agent tiers | [Core concepts](/agkit-docs/getting-started/concepts.md)       |
| Follow a task end-to-end                         | [Guides](/agkit-docs/guides/create-a-marketplace.md)           |
| Look up a command's flags                        | [Command reference](/agkit-docs/command-reference/commands.md) |
| See the palette, logo, and terminal theme        | [Brand & design](/agkit-docs/reference/brand.md)               |

Every guide is a runnable, copy-paste walkthrough. Start with [**Create a marketplace**](/agkit-docs/guides/create-a-marketplace.md) and follow the guides in order for the complete "create → add plugins → publish → update" loop.