plugins.sh CLI

plugins.sh is the package manager for searching, installing, updating, removing, and validating portable Agent Plugins.

Standard: Agent Plugins 1.0

npx plugins.sh search "design systems"
npx plugins.sh install openai/plugins/figma
npx plugins.sh update
npx plugins.sh list
npx plugins.sh validate owner/repository

search sorts by relevance and shows 20 results per page. Use --sort newest or --sort stars to reorder, --page 2 to keep browsing, --limit to change the page size (up to 100), and --verified to only show verified plugins.

install <slug> installs the exact indexed commit under ~/.agents and registers it with compatible clients detected on the machine. Bare install restores the commits and saved client targets in ~/.agents/plugins.lock.

Pass --client codex to target one client. Repeat --client to select more clients. The same option filters list, update, and outdated, while targeted remove unregisters only those clients. When Codex 0.147.0 or newer is available, the CLI completes its registration with codex plugin add.

validate reads a public GitHub repository directly and applies the same deterministic package checks used by the indexer.

Successful fresh adds send a pseudonymous install count. Set DO_NOT_TRACK=1 or PLUGINS_SH_TELEMETRY=0 to disable it.