AIX Command Line Interface (CLI) Master Guide

                    ┌─────────────────────────────────────────┐
                    │       AIX Core Agent Engine             │
                    │   (Action Traces / Verification Gates)  │
                    └────────────────────┬────────────────────┘
                                         │
                    ┌────────────────────┴────────────────────┐
                    │      AIX Vibe Multi-Agent Teams Engine  │
                    │ (Architecture / Dev / Data / QA / Ops)  │
                    └────────────────────┬────────────────────┘
                                         │
                    ┌────────────────────┴────────────────────┐
                    │       aix (AIX Enterprise Terminal)     │
                    │ • Default Target: sn (Internal Network) │
                    │ • Enterprise Gateway: aix.snnc.cc       │
                    │ • PAM Leases, AEP Gateways & Provenance │
                    └─────────────────────────────────────────┘

# Option 1: macOS / Linux one-click enterprise installation & bootstrap (Recommended)
curl -fsSL 'https://aix.snnc.cc/console/api/cli-bootstrap/install.sh?target=sn' | sh
 
# Option 2: Windows PowerShell native one-click installation
& ([scriptblock]::Create((irm 'https://aix.snnc.cc/console/api/cli-bootstrap/install.ps1?target=sn')))
 
# Option 3: Internal repository workspace registration (Platform contributors)
uv tool install --force .

$ aix doctor

╭── 🩺 AIX CLI Diagnostic Report (Profile: sn) ─────────────────────╮
│ • CLI Version   : aix-cli 1.0.0 (Python 3.12.3)                    │
│ • Auth Status   : Valid (User: xenodennis · Target: sn)            │
│ • Gateway Link  : Healthy (https://aix.snnc.cc · Latency: 42ms)    │
│ • Coding Pool   : agy-gcp (Active Tier: Cherub · gpt-4o)           │
│ • Zero-Trust    : Governed Sandbox Active (LocalPermissionManager) │
│ • CircuitBreaker: Armed (Threshold: 3 failures / 2 identical calls)│
│ • Git Worktree  : Clean (sn_operation_tower · Branch: main)        │
╰────────────────────────────────────────────────────────────────────╯

# List all configured profiles
aix profile list
 
# Switch to the global GCP profile
aix profile use gcp
 
# Read or modify CLI configurations
aix config get base_url
aix config set auto_approve true

# Enable autonomous mode via one-shot flag
aix -y "Add an LRU cache module and verify with unit tests"
aix --mode auto "Refactor order status state machine"
 
# Run a risk-free dry-run simulation
aix --plan "Refactor the settlement pipeline"

aix -y "In the current workspace data_platform directory, implement a pipeline health check module data_platform/pipeline_health.py and unit tests data_platform/test_pipeline_health.py, then run pytest to verify all tests pass. If any tests fail, autonomously self-heal until 100% green."

🔧 [CLI Agent Tool: write_workspace_file] data_platform/pipeline_health.py (20 lines)
🔧 [CLI Agent Tool: write_workspace_file] data_platform/test_pipeline_health.py (28 lines)
🔧 [CLI Agent Tool: run_governed_shell] !pytest data_platform/test_pipeline_health.py

============================== 3 passed in 0.01s ===============================

Data platform pipeline health checker and unit tests successfully delivered:
| Deliverable | Status |
| :--- | :--- |
| Health Checker (pipeline_health.py) | Completed (Source/Transform/Destination probes) |
| Unit Tests (test_pipeline_health.py)| Completed (Active, inactive, and exception handling) |
| Final Verification Gate | 3 passed in 0.01s (100% Green) |

aix -y "Run pytest data_platform/test_pipeline_health.py. If any tests fail, inspect the source and test code, analyze the root cause, autonomously edit the implementation, and re-run pytest until all tests pass."

# Step 1: Probe status
🔧 [CLI Agent Tool: run_governed_shell] !pytest data_platform/test_pipeline_health.py
  │ FAILED: test_pipeline_is_healthy - AssertionError: False is not true

# Step 2: Inspect code and tests
🔧 [CLI Agent Tool: read_workspace_file] data_platform/pipeline_health.py (L1-L10)
🔧 [CLI Agent Tool: read_workspace_file] data_platform/test_pipeline_health.py (L1-L28)

# Step 3: Local edit encounters hunk mismatch; Circuit Breaker radar trips immediately
╭── 🚨 [Circuit Breaker Alert] Infinite Failure Loop Intercepted ───╮
│ Status   : Tripped at Step 3 to prevent token exhaustion          │
│ Pattern  : Repetitive identical tool invocation failures          │
│ Strategy : PIVOT (Force architectural rewrite / avoid bad retries)│
╰───────────────────────────────────────────────────────────────────╯

# Step 4: Agent pivots to a clean full rewrite based on PIVOT directive
Agent Reasoning: "Detected editing misalignment. Pivoting to clean rewrite via write_workspace_file."
🔧 [CLI Agent Tool: write_workspace_file] data_platform/pipeline_health.py (10 lines)
🔧 [CLI Agent Tool: run_governed_shell] !pytest data_platform/test_pipeline_health.py

# Step 5: Uncaught exception discovered; agent analyzes and adds try/except robustness
Agent Reflection: "Test failed because mock source threw an unhandled exception. Wrapping checks in try/except."
🔧 [CLI Agent Tool: write_workspace_file] data_platform/pipeline_health.py (13 lines)
🔧 [CLI Agent Tool: run_governed_shell] !pytest data_platform/test_pipeline_health.py

============================== 3 passed in 0.01s ===============================
Agent Summary: "All unit tests have passed! The health checker now handles exceptions robustly."

$ aix

┌──────────────────────────────┬──────────────────────────────┐
│  1. Architecture & AST Index │  2. Self-Healing & QA Gate   │
│  • AST Nodes: 3,420 mapped   │  • Pytest: 373 Passed (100%) │
│  • Inbound Callers: 14 refs  │  • CDD Verification: ACTIVE  │
├──────────────────────────────┼──────────────────────────────┤
│  3. Zero-Trust Audit & PAM   │  4. Vibe Multi-Agent Squads  │
│  • Sandbox: Governed L2      │  • Architecture Team (Seraph)│
│  • PAM Lease: 24 min left    │  • Dev / QA Team (Cherub)    │
└──────────────────────────────┴──────────────────────────────┘

aix vibe "Design a CDD contract for container in-transit tracking and implement the ingestion pipeline"

$ aix vibe benchmark

  ✔ Suite 1: codebase_intelligence (AST index, python, tsx, sql, callers, glob, grep)
  ✔ Suite 2: atomic_multi_edit (multi-hunk atomic, AST check, diff snapshots)
  ✔ Suite 3: self_healing_verification_gate (AST + CDD + R1-R6 rules, 100% self-heal)
  ✔ Suite 4: three_layer_skills_and_zero_trust (SDLC + dp-* + sn-*, L3 zero-trust intercept)
  ✔ Suite 5: best_of_n_tournament (3-agent tournament, consensus judge, telemetry self-heal)
  ✔ Suite 6: skill_distillation_and_memory (session-to-skill, project memory persistence)
  ✔ Suite 7: polyglot_0_to_1_blueprint_and_smoke (py+go+java+tsx+sql, live HTTP smoke)
--------------------------------------------------------------------------------
Benchmark Summary: 7/7 suites passed (100.0%) in 146ms

# 1. List available application pack blueprints
aix aep packs
 
# 2. Initialize project from approved template pack
aix aep init my-inventory-checker --pack aix-governed-admin-pack
 
# 3. Run local contract and security verification
aix aep precheck --local
 
# 4. Deploy workload to enterprise Kubernetes cluster
aix deploy apply --env staging --manifest aep-app.yaml
 
# 5. Monitor status and rollback
aix deploy status
aix deploy rollback --revision 2

# List all local and hub-connected MCP servers
aix mcp list
 
# Test connectivity to enterprise Feishu MCP server
aix mcp test sn-feishu-mcp --ping
 
# List active skills (SDLC, Data Platform, Business Skills)
aix skills list
 
# Run domain skill directly
aix skills run sn-order-reconcile --date 2026-10-21

# Request a temporary PAM lease
aix permission pam request --scope prod-db --reason "Investigating stuck OMS queue" --duration 30m
 
# Inspect active lease
aix permission pam status
 
# Release lease immediately upon completion
aix permission pam revoke

# List available enterprise coding pools
aix model list
 
# Switch to Gemini Enterprise coding pool
aix model pool agy-gcp
 
# Inspect monthly seat quota and credit balance
aix billing balance
aix billing history

cd ~/Documents/Fun/SN/sn_commercial_tower
 
aix -y "Write an in-transit inventory reconciliation script check_in_transit.py matching ERP shipments with overseas warehouse receipts, and build accompanying tests test_check_in_transit.py. Run pytest and autonomously fix any mismatches until 100% green."

# 1. Request temporary 15-minute PAM lease
aix permission pam request --scope oms-sync --reason "Investigating deadlocked consumer" --duration 15m
 
# 2. Run autonomous investigation
aix --mode auto "Inspect OMS consumer logs, diagnose the deadlock cause, and implement recovery patch"
 
# 3. Revoke lease after verification
aix permission pam revoke

# Generate global semantic repo map for current workspace
aix map
 
# Target a specific subsystem with custom token budget
aix map src/core --tokens 1500
 
# Open interactively in REPL
aix > /map

# 1. Run command in background
aix task run "pytest tests/integration/ -v"
# Or inside interactive REPL:
aix > /bg pytest -v
 
# 2. Inspect active and historical tasks
aix task list
# Or inside REPL:
aix > /tasks
 
# 3. Stream real logs or terminate runaway tasks
aix task logs task-1792656712-672e --tail 50
aix task kill task-1792656712-672e
aix task clean

# 1. Record engineering convention or constraint
aix memory add "All public API routes must define Pydantic input schemas" --category architecture
aix memory add "Database migrations must maintain backward compatibility" --category convention
 
# 2. Query knowledge graph
aix memory search "Pydantic"
aix memory show
 
# 3. Session-to-Skill Distillation Flywheel
# Once the agent solves a difficult bug, crystallize its playbook into a reusable 3-Layer SKILL.md
aix skill distill fix-redis-deadlock --description "Investigate and resolve Redis distributed lock deadlocks"
# Or in REPL:
aix > /learn

# 1. Inspect cumulative session and project cost
aix cost
# Or inside REPL:
aix > /cost
 
# 2. View model pricing matrix
aix cost models
 
# 3. Reset telemetry data
aix cost reset

# 1. Inspect active routing policy (auto / cost / balanced / frontier)
aix model route show
# Or inside REPL:
aix > /route
 
# 2. Simulate prompt evaluation and estimated cost
aix model route eval "refactor core event loop to eliminate concurrency deadlock"
 
# 3. Dynamically set policy
aix model route set cost
aix model route set frontier

# 1. Scan entire workspace AST dependency graph
aix preflight
# Or inside REPL:
aix > /preflight
 
# 2. Scan specific subpackages
aix preflight src/services/order/
 
# 3. Machine-readable JSON output for CI quality gates
aix preflight --json

CLI Flags > Environment Variables > Local Project Config (.aix/config.json) > Global Profile (~/.aix/profiles.json)