Every AIPM command in one place.

via npm

Installs the AIPM CLI from npm for users who already have Node.js and npm.

npm install -g @aipm-registry/cli

via macOS/Linux standalone

Downloads the standalone binary and installs it into your local command path.

curl -fsSL https://github.com/abhisri2090/aipm/releases/download/cli-v0.2.12/install.sh | sh

via Homebrew

Installs the downloadable Homebrew formula directly from the CLI release.

brew install https://github.com/abhisri2090/aipm/releases/download/cli-v0.2.12/aipm.rb

via Windows PowerShell

Downloads the Windows installer script and installs aipm.exe.

irm https://github.com/abhisri2090/aipm/releases/download/cli-v0.2.12/install.ps1 | iex

via Scoop

Installs from the downloadable Scoop manifest attached to the CLI release.

scoop install https://github.com/abhisri2090/aipm/releases/download/cli-v0.2.12/aipm.json

Open login

Opens the AIPM website login flow used for accounts, orgs, package reservation, and tokens.

aipm login

• --no-open: print the login URL instead of opening a browser

Show CLI version

Confirms that the AIPM command is installed and available on PATH.

aipm --version

• Alias: aipm -v

Show help

Lists the available commands and top-level options.

aipm --help

• Use aipm <command> --help for command-specific options.

Run diagnostics

Checks Node, PATH, registry URL, project config, and publish readiness.

aipm doctor

• --registry <url>: check a specific registry
• --publish: focus on publish readiness
• --json: print machine-readable output

Show resolved config

Prints the registry, project config path, install root, and installed packages.

aipm config

• --registry <url>: override registry for this check
• --global: inspect global AIPM config
• --json: print machine-readable output

Initialize a project

Creates aipm.package.json in the current project and records the registry URL.

aipm init

• --registry <url>: set a custom registry
• --global: create global config instead of project config

Search packages

Searches the public registry by package name, target, or description.

aipm search sentry

• --limit <number>: cap result count
• --json: print machine-readable output
• --registry <url>: search another registry

Install one package

Adds a package to aipm.package.json and writes target-specific files into the project.

aipm add @scope/name@1.0.0 --target cursor --ci

• --target <tool>: cursor, claude, or *
• --ci: do not prompt interactively
• --token <token>: install private packages
• --global: install globally

Install configured packages

Installs every package already listed in aipm.package.json.

aipm install

• --target <tool>: install for one tool
• --ci: do not prompt interactively
• --token <token>: install private packages
• --global: use global config

List installed packages

Reads aipm-lock.json and shows the package versions installed for this project.

aipm list

• --global: list global packages

Update packages

Finds newer registry versions and reinstalls one package or all configured packages.

aipm update

• aipm update @scope/name: update one package
• --target <tool>: update for one target
• --ci: do not prompt interactively

Remove a package

Removes a package from AIPM config and lock files; review tool-written files before committing.

aipm remove @scope/name

• Alias: aipm rm @scope/name
• --global: remove from global config

Explain the publish flow

Prints the full account, package reservation, token, staging, and push flow.

aipm publish explain

Create a skill package

Creates a package folder with aipm.manifest.json, SKILL.md, .aipmignore, and local publish state.

aipm publish init --name @team/review-helper --template code-review --targets cursor

• --name <name>: required scoped package name
• --template <name>: blank, code-review, issue-summary, release-notes
• --targets <list>: comma-separated targets
• --dir <dir>: choose output folder
• --here: create files in the current folder

Create a skill package with the skill alias

Runs the same local package setup through the top-level skill command group.

aipm skill init --name @team/review-helper --template code-review

• Options match aipm publish init.

Import an existing skill

Copies an existing AI-tool skill file or folder into a new AIPM package folder.

aipm publish import ~/.codex/skills/review-helper --name @team/review-helper

• --name <name>: required package name
• --entry <file>: main file if not SKILL.md
• --targets <list>: supported tools
• --dir <dir>: choose output folder

Open publishing pages

Opens the publishing guide or the package dashboard from the terminal.

aipm publish open --package @team/review-helper

• --docs: open the publishing guide
• --no-open: print the URL instead of opening a browser

Stage files

Adds files to the publish bundle while respecting .aipmignore and secret-file exclusions.

aipm publish add .

Review staged files

Shows every staged file and whether it changed after staging.

aipm publish status

• --json: print machine-readable output

Preview upload

Shows package metadata, staged files, total size, and warnings before publishing.

aipm publish preview

• --json: print machine-readable output

Show staged changes

Lists staged files whose content changed after you last ran publish add.

aipm publish diff

Validate package

Checks the manifest, entry file, staged hashes, package size, ignored paths, and obvious secrets.

aipm publish validate

Open token page

Opens the package dashboard so you can generate a 5-minute publish token.

aipm publish token --package @team/review-helper

• --no-open: print the URL instead of opening a browser

Publish staged files

Uploads the staged package version to the registry with a short-lived publish token.

AIPM_TOKEN=<5-minute-token> aipm publish push --yes

• --token <token>: pass token as a flag
• --registry <url>: publish to another registry
• --yes: skip the final reminder

Publish a package directory directly

Publishes a complete directory containing aipm.manifest.json without using the staging flow.

AIPM_TOKEN=<5-minute-token> aipm publish ./path/to/skill --registry https://api.aipm-registry.com

• --token <token>: pass token as a flag
• --registry <url>: publish to another registry

Remove staged files

Removes paths from the publish stage without deleting them from disk.

aipm publish remove notes/private.md

• Alias: aipm publish rm <files...>

Clear publish stage

Clears all staged publish files so you can start staging again.

aipm publish reset