QuickCall SuperTrace - Tracing server for AI coding assistant sessions
Project description
SuperTrace - Monitor your AI coding sessions
See what your AI assistant is doing. Track inputs, outputs, and tool calls in real-time.
Install | Features | Configuration | Docker | Troubleshooting
Install
curl -fsSL https://quickcall.dev/supertrace/install.sh | sh
Then run:
quickcall-supertrace
Open http://localhost:7845 in your browser.
SuperTrace reads directly from Claude Code's JSONL transcript files at
~/.claude/projects/. No hooks or configuration needed.
100% Local - All data stays on your machine. Nothing is sent to any external servers.
Features
- Real-time monitoring - Watch AI assistant inputs/outputs as they happen
- Session timeline - Browse all your coding sessions
- Conversation view - See user prompts, assistant responses, and tool calls
- Full-text search - Find anything across all sessions
- Export - Download sessions as JSON or Markdown
- WebSocket updates - Live updates without page refresh
Dashboard Metrics
Hero Metrics (6-Panel Grid)
| Metric | Description |
|---|---|
| Commits | Git commits made during the session |
| Turns / Commit | Average prompts per commit (lower = faster delivery) |
| Tool Success Rate | Percentage of tool calls that completed successfully |
| Lines / Hour | Net lines changed per hour (productivity metric) |
| Images | Total images/screenshots shared in the session |
| Thinking | Prompts with extended thinking enabled (e.g., "3/10") |
Cost Analysis
| Metric | Description |
|---|---|
| Estimated Cost | Total USD cost based on Claude API pricing |
| Input Cost | Cost for context/input tokens |
| Output Cost | Cost for generated tokens |
| Cache Savings | Money saved from prompt caching |
Token Metrics (Per-Turn Chart)
- Input Tokens - Context sent per prompt
- Output Tokens - Tokens generated in response
- Cache Read Tokens - Tokens read from cache
- Cache Creation Tokens - Tokens written to cache
- Turn Duration - Time per prompt/response cycle
Tool Usage
- Tool Distribution - Breakdown by tool type (Read, Edit, Bash, etc.)
- Total Tools - Number of tool calls
- Tools Per Turn - Stacked visualization of tools used
Work Output
| Metric | Description |
|---|---|
| Files Changed | Unique files modified |
| Lines Added | Lines of code added |
| Lines Removed | Lines of code removed |
| Net Lines | Net change (added - removed) |
| Files Read | Files read for context |
AI Insights
- Session Intents - AI-detected goals for the session
- Intent Changes - Whether focus shifted during work
Time Filtering
All metrics support time range filtering: 1h, 2h, 6h, 24h, All
Configuration
| Env Variable | Default | Description |
|---|---|---|
QUICKCALL_SUPERTRACE_PORT |
7845 | Server port |
QUICKCALL_SUPERTRACE_HOST |
127.0.0.1 | Server host |
Docker
docker compose up -d
Troubleshooting
Port Already in Use
QUICKCALL_SUPERTRACE_PORT=8080 quickcall-supertrace
Reset Database
rm -rf ~/.quickcall-supertrace
Stop the Server
# Foreground: Ctrl+C
# Background: pkill -f quickcall-supertrace
Built with care by QuickCall
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file quickcall_supertrace-0.2.9.tar.gz.
File metadata
- Download URL: quickcall_supertrace-0.2.9.tar.gz
- Upload date:
- Size: 1.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4d1e6f7f1084d8352b123b8484bddf18f392d5341086e77295b1e8637376eeca
|
|
| MD5 |
f68277114f30b552e399e461c62d1e46
|
|
| BLAKE2b-256 |
3a087c8ab8d539c20576d7ba611922110a02d9c7b0fcfc963eebbd955e02d425
|
File details
Details for the file quickcall_supertrace-0.2.9-py3-none-any.whl.
File metadata
- Download URL: quickcall_supertrace-0.2.9-py3-none-any.whl
- Upload date:
- Size: 1.8 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b9da3b561a321d908d2d6c8d70740cec7bac552816d3c23c288f64edf2761f14
|
|
| MD5 |
5defce7c483d1069107acde3185ea240
|
|
| BLAKE2b-256 |
a376c678fa789ff0d438447069441e10cc0a4c06c467a2774377052f67d652fd
|
