AgentLensObservability for AI Agents

Open-source flight recorder for every tool call, approval, and data exchange your agents make.

Get Started

View on GitHub

🔌

MCP-Native

Ships as an MCP server — add one config block and every tool call is captured automatically. Zero code changes.

📊

Real-Time Dashboard

Session timelines, event explorer, cost analytics, and alerting — all in a beautiful web UI served by the same process.

🔗

AgentKit Ecosystem

First-class integrations with AgentGate (approval flows) and FormBridge (data collection). See the full agent lifecycle in one timeline.

🔒

Tamper-Evident Audit Trail

Append-only event storage with SHA-256 hash chains. Every event is immutable and cryptographically linked.

💰

Cost Tracking

Track token usage and estimated costs per session, per agent, over time. Set alerts for cost spikes before they become budget disasters.

🏠

Self-Hosted & Open Source

MIT licensed. SQLite by default — no external dependencies. Your data stays on your infrastructure.

Quick Start

Get AgentLens running in 60 seconds:

bash

# Install and start the server
npx @agentlensai/server

# Create an API key
curl -X POST http://localhost:3400/api/keys \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'

Then add AgentLens to your MCP agent config:

json

{
  "mcpServers": {
    "agentlens": {
      "command": "npx",
      "args": ["@agentlensai/mcp"],
      "env": {
        "AGENTLENS_API_URL": "http://localhost:3400",
        "AGENTLENS_API_KEY": "als_your_key_here"
      }
    }
  }
}

Open http://localhost:3400 and watch your agent's activity in real time.

→ Full Getting Started Guide