Skip to content

Use plugins ​

Universal Agent Plugins installs standard packages for the AI agents you select. A package can contain Skills, MCP server configuration, or both. You can install for your account or keep a project's dependencies separate.

Get the CLI ​

With Node.js 22 or newer, run the npm wrapper directly:

bash
npx universal-agent-plugins search docs

For repeated use, install it globally:

bash
npm install -g universal-agent-plugins
agentplugins version

Homebrew is another option:

bash
brew install 777genius/agentplugins/agentplugins

The native installation guide provides macOS, Linux and Windows instructions. Native installation needs no Node.js for the manager, although individual plugins may need their own runtime. Examples in this journey use agentplugins; npx universal-agent-plugins can run the same installer commands.

Follow the installation journey ​

  1. Find and inspect a package. Check its source and prerequisites.
  2. Preview your intended targets and scope with --dry-run.
  3. Apply the reviewed installation and follow its activation instructions.
  4. Maintain the installed state with list, update, repair and removal.
  5. Restore a shared dependency set from uap.toml and uap.lock when needed.

CLI is the current native installer. It adds a local management API and Pi extensions, Skills and stdio/Streamable HTTP MCP in user and eligible project scope. See local management and Pi compatibility. Package-manager channels can lag; check agentplugins version before relying on release-specific behavior. Use the native installer for the verified release. Explicit project scope works since 0.1.93. Most commands default to user scope. Since 0.1.94, install without a source argument or explicit scope selects a project only when a regular uap.toml exists in the exact current folder; it does not search parents. Select --scope project on project maintenance commands. Project support and client activation differ by target.

Read the result at the right level ​

Installation can still leave a client reload, trust prompt, manual activation or OAuth step. A Prepared result means more client work remains. Read each target's result rather than treating the whole operation as proof of runtime success. See client compatibility for the evidence behind versioned native observations.

If you are writing a package ​

Start with Build plugins. The shared handoff is a directory with root plugin.json and its components. It does not require the installer user to run source-build authoring tools.

CommandPurpose
agentplugins validate ./my-pluginRead and validate a local package for installation.
agentplugins doctorDiagnose installer-managed state.
agentplugins author validate ./my-pluginCheck authoring conformance and readiness in an authoring-enabled source build.
agentplugins author doctor ./my-pluginInspect project and toolchain evidence in that source build.

The current npm and native installer release does not include agentplugins author.

Public docs for plugin authors and integrators.