@aim-pos/aimpos-cli

AIM POS agent CLI — thin HTTP client over hardened pos-core APIs. Ships with the AIM Agent Skill for Claude Code, Cursor, and Codex.

Install

npm i -g @aim-pos/aimpos-cli
aimpos skill install

One-shot without a global install:

npx @aim-pos/aimpos-cli skill install
npx @aim-pos/aimpos-cli --help

aimpos skill install copies the packaged Skill to:

| Runtime | Path | |---|---| | Claude Code | ~/.claude/skills/aimpos/SKILL.md | | Cursor | ~/.cursor/skills/aimpos/SKILL.md | | Codex CLI | ~/.codex/skills/aimpos/SKILL.md |

Credentials

Set env vars (prefer env over CLI flags so secrets stay out of shell history):

| Variable | Purpose | |---|---| | AIM_AGENT_TOKEN | Bearer agent token (aimpos_<tenantId>_<secret>). Required. | | AIM_API_BASE_URL | API gateway base (default http://localhost:3000) | | AIM_STORE_ID | Sets x-store-id only when provided |

export AIM_AGENT_TOKEN=aimpos_<tenantId>_<secret>
export AIM_API_BASE_URL=https://your-gateway.example
export AIM_STORE_ID=<store-uuid>   # when APIs require store context
aimpos --help

Boundaries

• Read + suggest only — no writes through this CLI.
• A&D / Form 4473 are never writable through this interface.
• The Skill is guidance only; security is enforced by the API.

Monorepo development

pnpm --filter @aim-pos/aimpos-cli build
pnpm --filter @aim-pos/aimpos-cli test
pnpm --filter @aim-pos/aimpos-cli exec aimpos skill install

Publish (maintainers)

Requires an npm token with publish access to the aim-pos org (@aim-pos scope):

# from repo root
pnpm release:cli

Or:

pnpm --filter @aim-pos/aimpos-cli publish --access public