aip-cli

Install every plugin from a folder onto Claude Code, Codex, and Pi; enable them per folder; keep .aip-removed plugins off.

Why

AI agents load every enabled skill and agent into context. The more you have on, the less effective the agent gets — a frontend project doesn't need your Android skills, but they still eat context and crowd out what matters. You also hit hard limits, like the max-skills ceiling, once enough plugins pile up.

The usual fix is to uninstall and reinstall as you switch projects. That's slow and easy to forget.

aip-cli keeps everything installed but only activates what you explicitly enable for the current folder.

Use cases

• Match skills to the project. A frontend repo enables web skills and leaves Android, backend, and infra ones off — the agent stays focused and effective instead of wading through irrelevant tools.
• Stay under the limits. Installed enough plugins to blow past the max-skills ceiling? Only the current folder's set counts against it; the rest sit disabled.
• Use external plugins safely. Plugins you installed from others run only where they're relevant, not on globally.

How it works

• Put a .aip-cli.toml in a project folder (or let aip-cli mode write one).
• Run aip-cli enable to apply those plugins: claude/grok plugin enable|disable, and pi install|remove for the right set.
• Nothing runs on cd. Plugins only change when you run mode or enable.

Install

macOS / Linux:

git clone https://github.com/dan/aip-cli.git && cd aip-cli && make install

Quick start

# ingest every plugin (skips .aip-removed), install on Claude / Codex / Pi
aip-cli setup ~/projects/claude/plugins

# enable every store plugin (except .aip-removed) on this folder
aip-cli mode

# later: re-apply this folder's saved set
aip-cli enable

# recopy every installed plugin from last source
aip-cli refresh

aip-cli mode with no names enables every store plugin that is not .aip-removed. Pass names to enable only those. Writes .aip-cli.toml unless --no-save.

Marker file

mode = "apple backend-go"
# target = "grok"   # optional, defaults to all installed agents

Old markers that store keys such as mobile or minimal break (unknown mode).

See aip-cli --help for mode, enable, setup, list, and more.

Doctor

aip-cli doctor          # this folder
aip-cli doctor --dir X  # another folder

A read-only health check, all in one shot:

• Project — the .aip-cli.toml in scope, the plugins it enables, whether it's trusted and active.
• Store — every plugin in ~/.aip-cli/plugins, with versions.
• AI CLIs — per agent (claude, grok, pi): installed? which plugins are enabled vs disabled (read from ~/.claude/settings.json, ~/.grok/config.toml, and ~/.pi/agent/settings.json).

It flags drift (an agent missing a plugin it enables), orphans (enabled on an agent but not in the store), and plugins a folder wants that the store lacks. Store and per-agent reads run in parallel.

Build from source

git clone https://github.com/dan/aip-cli.git && cd aip-cli && make build && make test