Installation

AgentPlugins ships as a single Bun-compiled binary — no Node runtime required. Pick whichever install method fits your environment.

npm / npx

The CLI is published to npm as @agentplugins/cli. Run it ad-hoc with npx:

npx @agentplugins/cli@latest --version

Or install globally:

npm install -g @agentplugins/cli
agentplugins --version

Homebrew

Install from the_sigilco tap:

brew install sigilco/tap/agentplugins

Or install directly from the formula URL:

brew install https://raw.githubusercontent.com/sigilco/agentplugins/main/homebrew/Formula/agentplugins.rb

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.dev/install.sh | bash

TIP

Inspect the script before running it: curl -fsSL https://agentplugins.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.

Bun

If you have Bun installed, run the compiled binary directly via bunx:

bunx @agentplugins/cli@latest --version

Verify the install

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

agentplugins --version
# agentplugins 1.0.0

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

agentplugins doctor

AgentPlugins doctor
────────────────────────────────────────
CLI version      1.0.0
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.