How abhisheksarkar30/claude-lens works
Claude Lens is a local, single-user observability proxy and dashboard for Claude traffic. Its main workflow captures proxied requests and responses, then combines those records with Claude Code JSONL transcripts, quota snapshots, and Admin API reports to show calls, warnings, sessions, costs, and quota. The CLI and dashboard expose inspection and maintenance operations; replay reissues captured traffic through the proxy. The graph follows documented behavior and source-index references; some collector and dashboard internals were not sampled, so uncertain links are omitted.
Main entry points: store.go SQLite event store · jsonlogs.go Transcript tailer · consumer.go Event consumer · api.go Dashboard API
Components 25
Capture and ingest
- Traffic proxy
internal/proxy/proxy.go - Capture queue
internal/sink/sink.go - Event consumer
internal/consumer/consumer.go - Collector runner
internal/ingest/ingest.go - Transcript tailer
internal/jsonlogs/jsonlogs.go - Quota snapshot
internal/snapshot/snapshot.go - Usage and cost reports
internal/adminrep/adminrep.go
Analysis and billing
- Request parsing
internal/parse - Warning rules
internal/analyze/rules.go - Session grouping
internal/session/session.go - Cost pricing
internal/pricing/pricing.go - Quota calculations
internal/quota/quota.go - Cost reconciliation
internal/reconcile/reconcile.go
Persistence
- SQLite event store
internal/store/store.go
User interfaces
- Command dispatcher
cmd/clens/main.go - CLI operations
internal/cli - Dashboard API
internal/api/api.go - Dashboard UI
internal/web/app.js - Request replay
internal/replay/replay.go
Other components
- Developer
- Claude client
- Anthropic API
- Claude transcripts
- Usage endpoint
- Admin API
Connections 39
- Developer → Command dispatcher: runs commands
README.md - Command dispatcher → CLI operations: dispatches commands
cmd/clens/main.go - CLI operations → SQLite event store: queries or updates
- Claude client → Traffic proxy: sends traffic
README.md - Traffic proxy → Anthropic API: forwards requests
README.md - Traffic proxy → Capture queue: queues captures
internal/proxy/proxy.go - Capture queue → Event consumer: drains captures
internal/consumer/consumer.go - Event consumer → SQLite event store: writes events
internal/consumer/consumer.go - Event consumer → Request parsing: extracts usage
internal/consumer/consumer.go - Event consumer → Cost pricing: computes cost
internal/consumer/consumer.go - Event consumer → Warning rules: runs rules
internal/consumer/consumer.go - Event consumer → Session grouping: resolves sessions
internal/consumer/consumer.go - Claude transcripts → Transcript tailer: provides JSONL
README.md - Transcript tailer → SQLite event store: merges events
internal/jsonlogs/jsonlogs.go - Transcript tailer → Request parsing: parses records
internal/jsonlogs/jsonlogs.go - Transcript tailer → Cost pricing: prices events
- Transcript tailer → Warning rules: checks events
- Transcript tailer → Session grouping: records sessions
- Command dispatcher → Collector runner: runs collectors
- Collector runner → Transcript tailer: runs tailer
internal/ingest/ingest.go - Collector runner → Quota snapshot: runs poller
internal/ingest/ingest.go - Collector runner → Usage and cost reports: runs reports
internal/ingest/ingest.go - Quota snapshot → Usage endpoint: fetches utilization
- Usage and cost reports → Admin API: fetches reports
internal/adminrep/adminrep.go - Usage and cost reports → SQLite event store: writes report rows
internal/adminrep/adminrep.go - Quota snapshot → SQLite event store: writes snapshots
internal/snapshot/snapshot.go - Warning rules → Request parsing: inspects usage
internal/analyze/rules.go - Warning rules → SQLite event store: creates warnings
internal/analyze/rules.go - Session grouping → SQLite event store: updates aggregates
internal/session/session.go - Cost pricing → Request parsing: uses token usage
internal/pricing/pricing.go - Quota calculations → SQLite event store: reads usage
internal/quota/quota.go - Cost reconciliation → SQLite event store: compares costs
internal/reconcile/reconcile.go - Developer → Dashboard API: views dashboard
README.md - Dashboard API → SQLite event store: reads records
internal/api/api.go - Dashboard API → Dashboard UI: serves assets
internal/api/api.go - Dashboard API → Traffic proxy: reissues replay
internal/api/api.go - Dashboard API → Request replay: builds replay
- Request replay → SQLite event store: loads captured call
- CLI operations → Collector runner: refreshes collectors