CLI Reference

Developer and operator workflows from the terminal: discovery, API utilities, batch lifecycle, Maestro orchestration, and local warehouse/direct mode for the current Aweb provider catalog.

Installation

npm install -g @aweb/cli

Authentication

aweb login     # Opens browser for authentication
aweb whoami    # Show current user
aweb logout    # Clear session

Doctor

Use aweb doctor to inspect resolved transport, credential/session presence, mode readiness, and the current canonical command-tier boundary. This is the fast path for operators, developers, and agents to see what the CLI will actually do before invoking a route or workflow.

# Human-readable diagnostics
aweb doctor

# Machine-readable diagnostics
aweb doctor --json

Core commands

aweb doctorInspect resolved transport, auth, and mode readiness

aweb chat "<message>"Chat with the best available LLM

aweb image "<prompt>"Generate an image from text

aweb tts "<text>"Convert text to speech

aweb translate "<text>" --to <lang>Translate text to another language

aweb search "<query>"Search the web

aweb transcribe <audio_url>Transcribe audio to text

aweb video "<prompt>"Generate a video

aweb music "<prompt>"Generate music

aweb weather "<location>"Get weather data

aweb providersList all available providers

Capability discovery and lifecycle operations

The public CLI now has two higher-discipline platform surfaces: read-only capability discovery, and authenticated lifecycle commands for batch jobs and orchestration. Human output shows lifecycle objects like job, run, and audit_receipt; --json keeps the output machine-readable.

# Public discovery does not require an API key
aweb capabilities list
aweb capabilities get search.web

# Authenticated lifecycle routes require an AWeb API key
aweb config awebApiKey sk-aweb-...

# Batch lifecycle
aweb batch create --file requests.jsonl
aweb batch list --limit 20
aweb batch get batch_123
aweb batch cancel batch_123

# Orchestration lifecycle
aweb orchestrate run "Research the category and draft launch positioning" \
  --capability search.web \
  --capability llm.chat \
  --policy balanced

# Agent-safe machine output
aweb batch get batch_123 --json
aweb orchestrate run "Summarize risks" --json

Low-level API namespace

The higher-level CLI commands are optimized for natural-language routing and warehouse/direct mode. When you need the raw authenticated REST surface, use aweb api .... This namespace stays close to the public /api/v2 contract instead of the higher-level warehouse abstraction. Canonical lifecycle nouns such as batch and orchestrate stay top-level on purpose.

# Direct authenticated V2 route utilities
aweb api health
aweb api chat "Summarize launch risks"
aweb api image "Cinematic skyline at dusk"
aweb api webhooks list
aweb api keys rotate key_123

# Canonical lifecycle commands stay top-level
aweb batch create --file requests.jsonl
aweb batch list --json
aweb orchestrate run "Summarize risks" --json

Interactive mode

Run aweb with no arguments to enter the interactive REPL with 30+ slash commands.

aweb
# Opens interactive mode with:
#   /chat         — conversational AI
#   /persona      — create and manage AI personas
#   /agent        — build AI agents with voice and face
#   /new          — generate a new project
#   /edit         — edit existing files with AI
#   /fix          — fix errors and bugs
#   /memory       — view persistent memory
#   /help         — see all commands

Configuration

aweb config                        # Show all settings
aweb config model sonnet           # Set default model
aweb config awebApiKey sk-aweb-... # Set AWeb API key
aweb config apiKey sk-ant-...      # Set Anthropic key for code mode
aweb config baseUrl http://localhost:3005/api/v2 # Local API/direct-mode base
aweb config theme dark             # Set theme (dark/light/auto)

Config stored at ~/.config/aweb-cli/config.json. Environment variables AWEB_API_KEY, AWEB_BASE_URL, AWEB_API_URL, AWEB_CLI_AUTH_URL, and ANTHROPIC_API_KEY are also supported.

Quality analysis

The separate aweb-qa CLI runs 5 code quality analyzers with A-F grading.

npm install -g @aweb/qa-engine

aweb-qa scan              # Run all 5 analyzers
aweb-qa score             # Quick grade check
aweb-qa diff --base main  # Quality delta vs branch

Examples

Natural language routing

# Aweb classifies intent and routes to the right provider
aweb "generate a logo for a coffee shop"    # → image.generate
aweb "translate hello to Japanese"          # → translation.text
aweb "what's the weather in Tokyo"          # → weather.realtime

Code generation mode

aweb --code "build a calculator app"
# Opens interactive TUI with:
#   • Multi-file project generation
#   • Live preview
#   • Iterative editing
#   • One-click deployment