Install and use an agent

npm i -g anpm-io
anpm install @acme/code-reviewer

  ✓ code-reviewer installed  v1.2.0  by @acme
    scope: global | files: 5, symlinks: 2

    Included commands:
      /review    — Review code changes
      /suggest   — Suggest improvements

  💡 Usage: /review

That's it. The agent works in Claude Code, Cursor, Codex, Gemini CLI, and 4 more tools — no extra config.

# Install from GitHub — any repo with .claude/ or anpm.yaml
anpm install github:user/repo

# Install from a local directory
anpm install ./my-agent

# Already have .claude files? Manage them with anpm
anpm adopt ./my-project/.claude

# Run agents in an isolated environment
anpm run claude --with @acme/code-reviewer

# Auto-check for updates
anpm update
  ↑ @acme/code-reviewer 1.2.0 → 1.3.0

Publish and reach users

anpm create my-agent
anpm publish

  ✓ Published @you/my-agent v1.0.0
  ✓ Available on: Claude Code, Cursor, Codex, Gemini CLI +4

One publish. Users on any supported tool can install it immediately.

# Push an update
anpm publish --patch
  ✓ v1.0.0 → v1.0.1

# Check installs and versions
anpm info @you/my-agent
  @you/my-agent  v1.0.1  by @you
  installs: 1,234

  Recent versions:
    v1.0.1 (04/10) — Fix edge case handling
    v1.0.0 (04/01)

# DAU, WAU, version coverage → web dashboard
#   https://anpm.io/dashboard

Why anpm

AI agents are scattered across repos, gists, and blog posts. There's no standard way to install, share, or track them.

| Without anpm | With anpm | |---|---| | Clone repo, copy files, configure manually | anpm install @author/agent | | Works on one tool only | Works across 8+ AI tools | | No idea who uses your agent | Install counts, version tracking, dashboard | | Sharing = "copy this folder" | Sharing = anpm install @you/agent | | Updates = re-download and overwrite | anpm update | | Existing .claude files are unmanaged | anpm adopt brings them under control |

Supported Platforms

| AI Tool | Skills | Rules | Commands | Agents | |---|---|---|---|---| | Claude Code | ✅ | ✅ | ✅ | ✅ | | Cursor | ✅ | ✅ | ✅ | ✅ | | Codex CLI | ✅ | ✅ | ✅ | ✅ | | Gemini CLI | ✅ | ✅ | ✅ | ✅ | | Windsurf | ✅ | ✅ | ✅ | ✅ | | Cline | ✅ | ✅ | ✅ | ✅ | | RooCode | ✅ | ✅ | ✅ | ✅ | | OpenCode | ✅ | ✅ | ✅ | ✅ |

How It Works

                     anpm install @team/agent
                             │
                  ╭──────────┴──────────╮
                  │    anpm Registry    │
                  │     (anpm.io)      │
                  ╰──────────┬──────────╯
                             │
              ┌──────────────┼──────────────┐
              │              │              │
        ╭─────┴─────╮ ╭─────┴─────╮ ╭──────┴──────╮
        │  Claude   │ │  Cursor   │ │   Codex,    │
        │  Code     │ │  Windsurf │ │   Gemini,   │
        │           │ │  Cline    │ │   Roo ...   │
        ╰───────────╯ ╰───────────╯ ╰─────────────╯

One spec. Every tool. anpm handles the wiring.

Environment Lockfile

Pin agent versions per-project, like package-lock.json for agents:

anpm install @tools/formatter --save   # adds to anpm.yaml
anpm install                            # install all from lockfile
anpm run claude                         # launch with only declared agents

All Commands

| Command | Description | |---|---| | anpm install [slug] | Install an agent (registry, GitHub, or local) | | anpm publish | Publish to the registry | | anpm create <name> | Scaffold a new agent project | | anpm search <query> | Search the marketplace | | anpm update <slug> | Update to latest version | | anpm info <slug> | View agent details and install count | | anpm status | Show environment and installed agents | | anpm adopt <path> | Bring existing .claude files under anpm | | anpm list | List installed agents | | anpm run <tool> | Launch with isolated agent environment | | anpm diff <slug> | Compare local vs registry version | | anpm link | Link local agent for development | | anpm deploy | Deploy to cloud providers |

All commands support --json for structured output.

Open Source

MIT licensed. No vendor lock-in.

The hosted registry at anpm.io provides:

• Agent marketplace and discovery
• Private agents for organizations
• Install and usage analytics dashboard

Links

• anpm.io — Registry and marketplace
• Getting Started — Step-by-step guide
• npm package — npm i -g anpm-io