Igloo Agent Plugin

Universal compatibility installer for Claude-style agent plugin marketplaces.

igloo-agent-plugin reads a Claude Code marketplace (.claude-plugin/marketplace.json), normalizes plugin metadata and skills, then installs the portable skill subset into Claude, Codex, or Cursor layouts.

Install

npm install -g @iglooinsure/agent-plugin

The package exposes two commands:

igloo-agent-plugin --help
iap --help

Quick Start

igloo-agent-plugin marketplace add .
igloo-agent-plugin marketplace list
igloo-agent-plugin search
igloo-agent-plugin doctor ops-toolkit
igloo-agent-plugin install ops-toolkit --target codex --dry-run
igloo-agent-plugin install ops-toolkit --target codex

Commands

Marketplace

igloo-agent-plugin marketplace add <source>
igloo-agent-plugin marketplace list
igloo-agent-plugin marketplace refresh [name]

Supported sources:

• Local marketplace root containing .claude-plugin/marketplace.json
• Direct path to .claude-plugin/marketplace.json
• Git URL

CLI state is stored under ~/.igloo-agent-plugin by default. Set IGLOO_AGENT_PLUGIN_HOME to override it.

Search

igloo-agent-plugin search [query]
igloo-agent-plugin search kubernetes --target codex

Search lists marketplace plugin entries and their compatibility status. When no --target is given, compatibility is checked for all targets (claude, codex, cursor); pass --target to limit the check to a single target.

Install

igloo-agent-plugin install <plugin[@marketplace]> --target codex
igloo-agent-plugin install <plugin[@marketplace]> --target cursor
igloo-agent-plugin install <plugin[@marketplace]> --target claude
igloo-agent-plugin install <plugin[@marketplace]> --target all

Common options:

--scope user|project
--dry-run
--force
--symlink
--layout namespaced|flat

Codex installs are generated at:

~/.codex/plugins/<plugin-name>/
  .codex-plugin/plugin.json
  skills/<skill-name>/SKILL.md

~/.agents/plugins/
  marketplace.json
  <plugin-name>/

Cursor installs the skill subset at:

~/.cursor/skills/<plugin-name>/<skill-name>/SKILL.md

Claude support is currently a passthrough guide because Claude Code owns its native plugin install state.

Uninstall

igloo-agent-plugin uninstall <plugin> --target codex
igloo-agent-plugin uninstall <plugin> --target cursor

Uninstall only removes paths recorded in this CLI's install manifest.

Doctor

igloo-agent-plugin doctor
igloo-agent-plugin doctor --all
igloo-agent-plugin doctor ops-toolkit --target cursor

Doctor reports skill availability and warns about unsupported cross-tool components such as hooks, agents, MCP, LSP, monitors, commands, bin, and settings.

Development

This implementation intentionally has no runtime dependencies.

npm test

The tests use temporary HOME and IGLOO_AGENT_PLUGIN_HOME directories so they do not modify your real tool configuration.