Observability

curl http://localhost:7432/api/v1/metrics             # Prometheus text exposition
curl http://localhost:7432/api/v1/metrics/snapshot     # JSON, for the web UI

{
  "tokens_total": {
    "type": "counter",
    "description": "LLM tokens consumed, by model and direction (input/output)",
    "values": { "direction=input,model=claude-opus-4-8": 4210 }
  },
  "cost_usd_total": {
    "type": "counter",
    "description": "Estimated USD cost of LLM generations, by provider and model",
    "values": { "model=claude-opus-4-8,provider=anthropic": 0.1642 }
  },
  "process_cpu_percent": { "type": "gauge", "values": { "": 3.2 } },
  "process_memory_rss_bytes": { "type": "gauge", "values": { "": 84213760 } },
  "approval_decisions_total": {
    "type": "counter",
    "description": "Exec-approval gate outcomes, by decision (auto_approved/prompted/denied_outright)",
    "values": { "decision=auto_approved": 12 }
  }
}

{
  "host": {
    "cpu_percent": 3.2,
    "memory_rss_bytes": 84213760,
    "disk_usage_percent": 41.7,
    "disk_free_bytes": 128849018880
  }
}

curl http://localhost:7432/health   # always 200 once the process is up
curl http://localhost:7432/ready    # 200 once startup fully completes, 503 while initializing

neuralcleave usage
curl http://localhost:7432/api/v1/usage

scrape_configs:
  - job_name: neuralcleave
    static_configs:
      - targets: ['localhost:7432']
    metrics_path: /api/v1/metrics