◆
Agent Trail
GitHub npm Install

Session Replay · Subagent Trees · Token Tracking

AI coding agent
observability dashboard

Track token usage, estimated cost, tool calls, subagent trees, and replay full sessions from local JSONL / SQLite files — Claude Code, Codex, OpenCode, OpenClaw, and Qoder.

Session replay Subagent trees Tool call inspector Token & cost tracking
◆ View on GitHub npm package
Screenshots
Agent Trail overview dashboard

Overview — token usage, cost, and live activity across all agents

Agent Trail session replay

Session replay — step through turns, expand tool calls, trace subagent trees

Use cases
Turn-by-turn replay
Step through every conversation turn exactly as it happened — user messages, assistant responses, and hidden system context all in one view.
Tool calls & subagent trees
Expand any tool invocation to see its exact inputs and outputs. When an agent spawns subagents, the full nested tree is rendered so you can trace what each one did.
Multi-agent support
One dashboard for Claude Code, Codex, OpenCode, OpenClaw, and Qoder. Switch between agents without leaving the UI.
Token usage & cost tracking
Input, output, cache, and reasoning tokens per turn. Estimated USD cost rolled up by session, project, and model — all computed locally.
Supported AI coding agents
Claude Code
Subagent tree replay Tool call detail Per-turn token accounting Injected context blocks
OpenClaw
Live gateway ingest Real-time activity feed Tool call & skill replay Agent cost overview
Codex
Parent-child session trees Full turn-by-turn replay Token usage tracking Model breakdown
OpenCode
Full session history Multi-model sessions Turn-level detail Cost estimation
Qoder
Session browsing Token count tracking Usage trends
Install
Option 1 — npm (Node.js 22+)
npm install -g @camtrik/agent-trail
agent-trail
Option 2 — Docker (no Node.js required)
docker compose -f docker-compose.image.yml up -d
# open http://localhost:3030
Option 3 — From source
git clone https://github.com/camtrik/agent-trail.git
cd agent-trail && pnpm install && pnpm dev
Privacy
◆ Local only

No data leaves your machine. Agent Trail parses your JSONL files into a local SQLite database at ~/.agent-trail/. The dashboard is read-only — it replays recorded tool calls, never re-executes them. No telemetry, no analytics, no cloud sync.