Skip to content
Lookspan

CLI options

Terminal window
npx lookspan [options]

Options

  -p, --port <port>        Port to listen on            (default: 3100)
      --host <host>        Host to bind to              (default: 127.0.0.1)
      --db <path|url>      SQLite path or postgres:// URL (default: ~/.lookspan/lookspan.db)
      --retention <dur>    Prune traces older than e.g. 7d, 24h, 30m
      --token <token>      Require Authorization: Bearer <token> on the API
      --pricing <file>     Custom model pricing table (JSON)
      --alert-error                Alert when a trace fails
      --alert-cost <usd>           Alert when a trace costs more than <usd>
      --alert-tokens <n>           Alert when a trace exceeds <n> tokens
      --alert-duration <ms>        Alert when a trace takes longer than <ms>
      --openai-key <k>             OpenAI key for Replay & judge (in memory only)
      --anthropic-key <k>          Anthropic key for Replay & judge (in memory only)
      --open               Open the dashboard in your browser
  -h, --help               Show help
  -v, --version            Show version

Every flag has a LOOKSPAN_* environment-variable equivalent (LOOKSPAN_PORT, LOOKSPAN_TOKEN, LOOKSPAN_PRICING, LOOKSPAN_ALERT_*, …). See the configuration reference for the complete flag + env-var table, defaults and examples.

Provider keys

Replay & LLM-as-judge read LOOKSPAN_OPENAI_API_KEY / LOOKSPAN_ANTHROPIC_API_KEY (or --openai-key / --anthropic-key). These stay in memory and are never persisted or logged.

Examples

Terminal window
# Default: localhost:3100, ephemeral, no auth
npx lookspan


# Open the dashboard automatically
npx lookspan --open


# Different port, keep a week of history
npx lookspan -p 4000 --retention 7d


# Expose on the LAN behind a token (see Security note in Configuration)
LOOKSPAN_TOKEN=secret npx lookspan --host 0.0.0.0