AIX CLI

Command-line interface for AIX. It now supports both:

• LLM decision commands for routing inspection
• Coding Session commands for hosted Coding Agent Orchestration

Setup

# From repo root
cd packages/aix-cli

# Optional for local dev
export AIX_API_URL=http://localhost:5000   # or https://aix.cloudverse.ai

Login

Use device login for developer-facing coding flows:

aix login

Commands

aix code start

Create a draft coding session:

aix code start \
  --repo cloudverse/aix-web \
  --branch feature/coding-session \
  --type implementation \
  --instruction "Add coding session API" \
  --mode patch_proposal

aix code assess

Assess readiness, blockers, workflow, and cost:

aix code assess --session cs_123 --file server/coding-session/routes.ts

aix code plan

Create a bounded workflow plan:

aix code plan --session cs_123

aix code run

Execute the latest or specified plan:

aix code run --session cs_123 --mode patch_proposal --follow

aix code status

Inspect current run state:

aix code status --session cs_123 --run run_123 --follow

aix code result

Show result summary, affected files, findings, and open-in-web link:

aix code result --session cs_123 --run run_123

aix code refine

Create a new plan version in the same session:

aix code refine --session cs_123 --instruction "Move the result pane into the right rail"

aix code resume

Resume an approved paused run safely:

aix code resume --session cs_123 --run run_123 --follow

aix code open

Open the session in AIX web:

aix code open --session cs_123

aix decide

Request a routing decision from the AIX LLM Decision Engine.

# Basic decision
npx tsx src/index.ts decide --execution-class conversation

# With priority and constraints
npx tsx src/index.ts decide \
  --execution-class code_generation \
  --priority quality \
  --max-cost-usd 0.05 \
  --max-latency-ms 3000

# With token estimates for cost simulation
npx tsx src/index.ts decide \
  --execution-class conversation \
  --input-tokens 1000 \
  --output-tokens 500

# JSON output
npx tsx src/index.ts decide --execution-class conversation --format json

# From intent JSON file
npx tsx src/index.ts decide --intent-json ./my-request.json

aix explain <decision_id>

Get explanation and trace for a past decision.

npx tsx src/index.ts explain dec_abc123
npx tsx src/index.ts explain dec_abc123 --format json

aix health

Check AIX LLM Decision Engine health and coverage.

npx tsx src/index.ts health

aix policy show

Show current org routing policy.

npx tsx src/index.ts policy show

aix catalog status

Show catalog status and coverage.

npx tsx src/index.ts catalog status

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | AIX_API_URL | No | http://localhost:5000 | AIX server base URL | | AIX_TOKEN | No | — | Optional bearer token override |

*Not required if server allows unauthenticated access in local dev mode.

Output Formats

• --format pretty (default): Human-readable with color coding
• --format json: Raw JSON for piping to other tools
• --json on coding commands: machine-readable session/run payloads