laudec

See everything Claude Code does. One binary. One command.

laudec wraps Claude Code with a transparent proxy, OTEL collector, and web dashboard — giving you full visibility into every API call, token, tool use, and prompt that flows through a session.

Install

One-liner (requires git, Rust, and Node.js):

curl -fsSL https://raw.githubusercontent.com/devindudeman/laudec/main/install.sh | bash

Or manually:

git clone https://github.com/devindudeman/laudec.git
cd laudec
cd dashboard && npm install && npm run build && cd ..
cargo install --path .

Works on Linux and macOS. Requires Claude Code installed.

Quick Start

cd your-project/
laudec .

That's it. laudec launches Claude Code with instrumentation wired up automatically. Open the dashboard URL printed at startup.

What You Get

Proxy Tab

Full API traffic inspection for every request to Anthropic:

• Calls classified by type (MAIN, SUBAGENT, QUOTA, TOKEN COUNT, CONNECTIVITY) with color-coded pills
• MAIN calls labeled by turn number (TURN 1, TURN 2) or continuation (TURN 1+)
• Subagent calls tagged with role (EXPLORE, WEB SEARCH, CC GUIDE) and labeled INSTRUCTION instead of YOU
• Connectivity probes (HEAD /) identified and labeled
• Three view modes per card: CONV (default for conversation calls), INSPECT, RAW
• CONV view: user query, model response as markdown, tool calls (amber) with input summary, tool results (purple) with output preview, system blocks collapsible
• INSPECT view: structured request body broken into 4 sections:
  • Parameters strip (model, max_tokens, thinking, effort, stream)
  • System blocks (collapsible with cache indicators)
  • Messages (compact rows with role, block counts, token estimates, expandable for full content including thinking blocks)
  • Tools inventory (grouped by source: native vs MCP by server, clickable pills for schema)
• RAW view: collapsible JSON tree with smart previews (identity values for arrays, light-background syntax highlighting)
• Tool calls extracted from SSE responses at capture time (MCP tools show server/tool format)
• Token counts, cache, latency, model, and status per call

Events Tab

OTEL telemetry grouped by conversation turn:

• User prompts, API requests, tool decisions, and tool results
• Per-turn token/cost breakdown
• Tool parameters and error details

Metrics Tab

Session-level summary:

• Total cost, API call count, average latency, cache hit rate
• Token breakdown (input / output / cache) as a stacked bar
• Per-call table with totals
• Tool usage with success/failure counts

Insights Tab

Derived analytics from proxy headers and response bodies:

• Cache analysis — hit rate, estimated cost savings, cache read/write totals
• Stop reasons — breakdown of end_turn, tool_use, max_tokens across all calls
• System prompt size — estimated token count of your system prompt
• Context growth — input tokens per call showing context window fill-up over time
• Rate limits — remaining requests/tokens from Anthropic response headers, with warning thresholds

How It Works

Claude Code  -->  laudec proxy  -->  Anthropic API
     |                 |
     |                 v
     |           SQLite (api_calls)
     |
     +-->  laudec OTEL collector (gRPC)
                       |
                       v
                 SQLite (otel_events, otel_metrics)

laudec sits between Claude Code and Anthropic's API:

1. Proxy — An HTTP proxy that intercepts all API calls, logs request/response bodies, parses token usage, and forwards to Anthropic
2. OTEL Collector — A gRPC server that receives OpenTelemetry logs and metrics from Claude Code (prompts, tool usage, costs)
3. Dashboard — A Svelte SPA served by the same binary, querying the SQLite database

All data is stored locally in ~/.local/share/laudec/laudec.db.

CLI

laudec .                        # Run Claude Code with full instrumentation
laudec . -p "fix the tests"    # Single prompt (non-interactive)
laudec dashboard                # Start dashboard without launching Claude Code
laudec log                      # View session history
laudec log --all                # All projects
laudec calls --session ID       # View API calls for a session
laudec events --session ID      # View OTEL events
laudec replay SESSION_ID        # Replay a session timeline
laudec stats                    # Show usage statistics
laudec init                     # Generate starter laudec.toml
laudec config                   # Print resolved configuration

Configuration

Generate a starter config:

laudec init

This creates laudec.toml in your project directory. Config is also loaded from ~/.config/laudec/config.toml for global defaults.

Key options

[proxy]
enabled = true
port = 18080
log_requests = true       # Log request bodies
log_responses = true      # Log response bodies
redact_keys = true        # Redact API keys in stored headers

[telemetry]
enabled = true
collector_port = 14317
log_prompts = true        # Store user prompts from OTEL
log_tool_details = true   # Store tool parameters/results

[dashboard]
enabled = true
port = 18384

[sandbox]
enabled = true
allowed_domains = []      # Additional domains beyond api.anthropic.com
allow_write = false

[permissions]
mode = "plan"             # "plan", "auto", or "bypassPermissions"
allow = []                # Tool allow list
deny = []                 # Tool deny list

[claude]
# model = "claude-sonnet-4-6"  # Override default model

Remote mode

Point proxy or collector at an existing instance:

[proxy]
remote = "http://shared-proxy:18080"

[telemetry]
remote = "http://shared-collector:14317"

Building from Source

Requirements:

• Rust toolchain (1.75+)
• Node.js (18+)

# Build the dashboard frontend first
cd dashboard && npm install && npm run build && cd ..

# Build the binary (embeds the dashboard)
cargo build --release

# Binary is at target/release/laudec

Data

All data lives in a single SQLite database:

# Default location
~/.local/share/laudec/laudec.db

# Override with environment variable
export LAUDEC_DATA_DIR=/path/to/data

Inspect directly:

sqlite3 ~/.local/share/laudec/laudec.db "SELECT * FROM sessions ORDER BY started_at DESC LIMIT 5"
sqlite3 ~/.local/share/laudec/laudec.db "SELECT * FROM session_id_map"

License

MIT