Local-first observability for AI agents, in one command

Jonathan Martin Paez — Tue, 02 Jun 2026 18:17:54 +0000

When an AI agent misbehaves — fails, stalls, or quietly burns tokens — you need
to see the steps. But most observability tools are cloud-first: accounts, API
keys, and shipping your prompts to someone else's servers.

I built Lookspan to be the opposite. It runs on your machine, stores everything
in local SQLite, and starts with one command:

npx lookspan

Open http://127.0.0.1:3100 and you get a real-time dashboard: traces, a span
graph, cost per model, latency percentiles, and alerts.

Send it data

Any language, raw HTTP:

curl -X POST http://127.0.0.1:3100/api/ingest -H "Content-Type: application/json" -d '{...}'

MCP (TypeScript):

npm i @lookspan/mcp

Python (LangGraph, CrewAI, or generic):

pip install lookspan

Already using OpenTelemetry? Point your OTLP exporter at it — no Lookspan SDK:

OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://127.0.0.1:3100/v1/traces

[aquí: GIF de demo + captura del dashboard]

It's MIT and early (v0.1). Repo + roadmap: https://github.com/JoniMartin27/lookspan

DEV Community: Jonathan Martin Paez

Local-first observability for AI agents, in one command

Send it data