Command Reference

Command reference

aim-cli has managed commands for instructions, prompts, and profiles, pull-request workflows for local edits, and a local-only status command.

Instruction commands

• aim-cli instruction install <technical-name>
• aim-cli instruction update <technical-name>
• aim-cli instruction remove <technical-name>

Use these commands for instructions you want to manage directly.

Prompt commands

• aim-cli prompt install <technical-name>
• aim-cli prompt update <technical-name>
• aim-cli prompt remove <technical-name>

Use these commands when you want to keep approved prompts as tracked files in .aim-prompts.

Profile commands

• aim-cli profile install <technical-name>
• aim-cli profile update <technical-name>
• aim-cli profile remove <technical-name>

Use these commands when a profile should control the instruction set in your project.

Pull-request commands

• aim-cli pr diff <instruction|prompt|profile> <technical-name>
• aim-cli pr diff all
• aim-cli pr diff <instruction|prompt|profile> --all
• aim-cli pr create <instruction|prompt|profile> <technical-name>

Use these commands to review local changes against the accepted tenant version and propose create, update, or delete pull requests.

Status command

• aim-cli status

This command reads your local files and prints the installed profiles and instructions. It does not prompt for credentials.

Common flags

• --api-url — base URL of the A.I.M. API. Default: https://aim.ben-fischer.dev
• --agents-file — path to the target AGENTS.md file. The sibling manifest and .aim-prompts directory are resolved from the same location. Default: AGENTS.md

Environment variables

• AIM_API_URL — default value for --api-url
• AIM_AGENTS_FILE — default value for --agents-file