Installation

Pick whichever install method fits your environment.

npm / bun

The CLI is published to npm as @agentplugins/cli. Install globally:

npm

npm install -g @agentplugins/cli

bun

bun add -g @agentplugins/cli

Or run it ad-hoc with npx:

npx @agentplugins/cli@latest --version

Homebrew

Install from the sigilco/homebrew-tap-agentplugins tap:

brew install sigilco/tap-agentplugins/agentplugins

Upgrade with brew upgrade agentplugins.

curl

The install script downloads the correct prebuilt binary for your platform and drops it into /usr/local/bin:

curl -fsSL https://agentplugins.pages.dev/install.sh | bash

TIP

Inspect the script before running it: curl -fsSL https://agentplugins.pages.dev/install.sh | less.

mise

Manage AgentPlugins as a version-pinned tool with mise (uses ubi under the hood to pull GitHub releases):

mise use -g ubi:sigilco/agentplugins

This pins the latest release globally. Use mise use ubi:sigilco/agentplugins@1.2.0 to pin a specific version per project.

Verify the install

Whichever method you chose, confirm the binary is on your PATH:

agentplugins --version
# agentplugins/x.y.z

Then run doctor to verify AgentPlugins can detect every installed agent harness on your machine:

agentplugins doctor

AgentPlugins doctor
────────────────────────────────────────
CLI version      x.y.z
Store path       ~/.agents/plugins       ✓
Skills path      ~/.agents/skills        ✓

Detected agents
  claude         ~/.claude/skills        ✓
  codex          ~/.codex/skills         ✓
  opencode       ~/.config/opencode      ✓
  gemini         ~/.gemini/skills        ✗ (not installed)
  copilot        ~/.copilot/skills       ✓
  kimi           ~/.kimi/skills          ✗ (not installed)
  pimono         ~/.pi/extensions        ✗ (not installed)

4 agents detected. Plugins will fan out to those harnesses.

WARNING

doctor only reports detection. Plugins still install to the universal store (~/.agents/plugins/) regardless of how many agents are found. Symlinks are created only for detected agents.

Next steps

• Quick start — install your first plugin.
• Creating plugins — scaffold a new plugin from a template.