Every AIPM command in one place.

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>: override stored login for CI
• --global: use global config

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
• --no-init: update one package to latest without reading or writing aipm.package.json or aipm-lock.json
• --token <token>: override stored login for CI
• --ci: do not prompt interactively

Initialize a project

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

aipm init --target claude

• --target <tool>: set cursor, claude, codex, or * without prompting
• --registry <url>: set a custom registry
• --global: create global config instead of project config

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 claude --ci

• --target <tool>: cursor, claude, codex, or *
• --no-init: install without creating or updating aipm.package.json or aipm-lock.json
• --ci: do not prompt interactively
• --token <token>: override stored login for CI
• --global: install globally

Search packages

Searches registry packages. Private matches are included after aipm login.

aipm search sentry

• --limit <number>: cap result count
• --json: print machine-readable output
• --registry <url>: search another registry
• --token <token>: use an explicit install token

List installed packages

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

aipm list

• --global: list global packages

Show setup prompt

Prints the manual AI setup prompt installed with a package.

aipm show-prompt @scope/name

• --global: read from global AIPM config

Clean helper files

Deletes temporary helper files installed with a package without removing skills or permanent files.

aipm cleanup @scope/name --yes

• --yes: skip confirmation
• --global: clean global helper files

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
• --no-init: delete discovered skill files without reading or writing aipm.package.json or aipm-lock.json
• --global: remove from global config

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

CLI login

Opens the browser login flow and stores a local CLI session for private package installs.

aipm login

• --registry <url>: login for another registry
• --site <url>: use another website origin
• --no-open: print the login URL instead of opening a browser

Show current login

Shows the stored CLI account and orgs available to this terminal.

aipm whoami

• --registry <url>: inspect another registry login
• --json: print machine-readable output

CLI logout

Revokes the stored CLI session and removes it from this machine.

aipm logout

• --registry <url>: logout from another registry

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 skill 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 skill 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