AIX CLI

Command-line interface for the AIX Brain Decision Engine. Decision-only surface — no gateway behavior, no prompt proxying.

Setup

# From repo root
cd packages/aix-cli

# Set environment
export AIX_API_URL=http://localhost:5000   # or https://aix.cloudverse.ai
export AIX_TOKEN=your_api_key_here         # AIX API key or legacy key

Commands

aix decide

Request a routing decision from the AIX Brain.

# 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 Brain 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 | Yes* | — | API key for authentication |

*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