# Claude Trace Viewer
An alternate web-based viewer for trace logs generated by [@mariozechner/claude-trace](https://github.com/mariozechner/claude-trace).
## About
This tool provides a complementary viewing experience for trace logs created by `@mariozechner/claude-trace`. While the original tool creates the trace files during Claude Code conversations, this viewer offers an alternate way to explore and analyze those logs with features like sub-agent detection and timeline visualization and a UI inspired by the browser developer tools network tab for viewing details about individual requests.
## What are claude-trace files?
Running `claude-trace` launches Claude Code and generates JSON logs during the conversations. These files contain detailed information about tool usage, timing, and the flow of operations during a Claude session.
By default, trace files are stored in `.claude-trace` directory where you launch `claude-trace`. Each trace file represents a single conversation or task execution, allowing you to analyze Claude's decision-making process and performance.
## Prerequisites
First, install [@mariozechner/claude-trace](https://github.com/mariozechner/claude-trace) to generate trace files:
```bash
npm install -g @mariozechner/claude-trace
```
This will enable trace logging for your Claude Code conversations.
## Installation
```bash
# Run directly with uvx (no installation needed)
uvx claude-trace-viewer
# Or install with pip/uv
pip install claude-trace-viewer
# or
uv add claude-trace-viewer
```
## Usage
```bash
# View traces in current directory (has a `.claude-trace` folder)
claude-trace-viewer
# Specify a different directory
claude-trace-viewer --trace-dir /path/to/directory/that/contains/.claude-trace
# Use a different port, ex: 5000
claude-trace-viewer --port 5000
```
Click the link printed in the terminal to open the web interface in your browser, defaults to `http://127.0.0.1:8080`.
## Features
- Choose from any of the available trace files in the specified directory
- Interactive timeline visualization
- Sub-agent detection and visualization
- Search and filter capabilities
- Export trace data
- Browser Developer Tools-like interface for detailed request inspection
## Development
```bash
# Clone the repository
git clone https://github.com/brkrabac/claude-trace-viewer.git
cd claude-trace-viewer
# Install in development mode
pip install -e .
```
## Troubleshooting
### No trace files found
If the viewer shows no trace files, ensure that:
- You're pointing to the correct directory (default is `.claude-trace` in the current working directory)
- Claude has generated trace files during your conversations, go to `.claude-trace` and verify that there are JSON files present
- You have read permissions for the trace directory
## License
MIT
Raw data
{
"_id": null,
"home_page": null,
"name": "claude-trace-viewer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "claude, trace, viewer, debugging, visualization, claude-ai, anthropic, claude-trace, log-viewer",
"author": "Brian Krabach",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/9f/d8/0fefad86be86b5c531233ad440e288c92f6ca6e9e301f9c9f2c0a0fe3c03/claude_trace_viewer-0.2.0.tar.gz",
"platform": null,
"description": "# Claude Trace Viewer\n\nAn alternate web-based viewer for trace logs generated by [@mariozechner/claude-trace](https://github.com/mariozechner/claude-trace).\n\n## About\n\nThis tool provides a complementary viewing experience for trace logs created by `@mariozechner/claude-trace`. While the original tool creates the trace files during Claude Code conversations, this viewer offers an alternate way to explore and analyze those logs with features like sub-agent detection and timeline visualization and a UI inspired by the browser developer tools network tab for viewing details about individual requests.\n\n## What are claude-trace files?\n\nRunning `claude-trace` launches Claude Code and generates JSON logs during the conversations. These files contain detailed information about tool usage, timing, and the flow of operations during a Claude session.\n\nBy default, trace files are stored in `.claude-trace` directory where you launch `claude-trace`. Each trace file represents a single conversation or task execution, allowing you to analyze Claude's decision-making process and performance.\n\n## Prerequisites\n\nFirst, install [@mariozechner/claude-trace](https://github.com/mariozechner/claude-trace) to generate trace files:\n\n```bash\nnpm install -g @mariozechner/claude-trace\n```\n\nThis will enable trace logging for your Claude Code conversations.\n\n## Installation\n\n```bash\n# Run directly with uvx (no installation needed)\nuvx claude-trace-viewer\n\n# Or install with pip/uv\npip install claude-trace-viewer\n# or\nuv add claude-trace-viewer\n```\n\n## Usage\n\n```bash\n# View traces in current directory (has a `.claude-trace` folder)\nclaude-trace-viewer\n\n# Specify a different directory\nclaude-trace-viewer --trace-dir /path/to/directory/that/contains/.claude-trace\n\n# Use a different port, ex: 5000\nclaude-trace-viewer --port 5000\n```\n\nClick the link printed in the terminal to open the web interface in your browser, defaults to `http://127.0.0.1:8080`.\n\n## Features\n\n- Choose from any of the available trace files in the specified directory\n- Interactive timeline visualization\n- Sub-agent detection and visualization\n- Search and filter capabilities\n- Export trace data\n- Browser Developer Tools-like interface for detailed request inspection\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/brkrabac/claude-trace-viewer.git\ncd claude-trace-viewer\n\n# Install in development mode\npip install -e .\n```\n\n## Troubleshooting\n\n### No trace files found\n\nIf the viewer shows no trace files, ensure that:\n\n- You're pointing to the correct directory (default is `.claude-trace` in the current working directory)\n- Claude has generated trace files during your conversations, go to `.claude-trace` and verify that there are JSON files present\n- You have read permissions for the trace directory\n\n## License\n\nMIT\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "An alternate web-based viewer for logs generated by @mariozechner/claude-trace",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/brkrabac/claude-trace-viewer",
"Repository": "https://github.com/brkrabac/claude-trace-viewer"
},
"split_keywords": [
"claude",
" trace",
" viewer",
" debugging",
" visualization",
" claude-ai",
" anthropic",
" claude-trace",
" log-viewer"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "69ce3ead95ece2baf1175b844674bbbc9692c64327cf213d5335192459974b77",
"md5": "ab2d5128028f1f56053efa308156279a",
"sha256": "dc411bf0e9629615c0ac4555c76e5ee85fe4ba1b63d8e8b4529ea2b16bff6031"
},
"downloads": -1,
"filename": "claude_trace_viewer-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ab2d5128028f1f56053efa308156279a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 34215,
"upload_time": "2025-09-12T23:40:40",
"upload_time_iso_8601": "2025-09-12T23:40:40.162345Z",
"url": "https://files.pythonhosted.org/packages/69/ce/3ead95ece2baf1175b844674bbbc9692c64327cf213d5335192459974b77/claude_trace_viewer-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9fd80fefad86be86b5c531233ad440e288c92f6ca6e9e301f9c9f2c0a0fe3c03",
"md5": "6497b08bf5491feee003410574cec57e",
"sha256": "eb65b7bb463c306a515c90111883bc56401c648914a8e107abe953ef77fcd918"
},
"downloads": -1,
"filename": "claude_trace_viewer-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "6497b08bf5491feee003410574cec57e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 31410,
"upload_time": "2025-09-12T23:40:41",
"upload_time_iso_8601": "2025-09-12T23:40:41.208902Z",
"url": "https://files.pythonhosted.org/packages/9f/d8/0fefad86be86b5c531233ad440e288c92f6ca6e9e301f9c9f2c0a0fe3c03/claude_trace_viewer-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-12 23:40:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "brkrabac",
"github_project": "claude-trace-viewer",
"github_not_found": true,
"lcname": "claude-trace-viewer"
}
JSON
