https://github.com/matt1398/claude-devtools
The missing DevTools for Claude Code — inspect session logs, tool calls, token usage, subagents, and context window in a visual UI. Free, open source.
https://github.com/matt1398/claude-devtools
ai ai-agent ai-debugging ai-tools anthropic claude claude-code claude-code-tools debugging desktop-app developer-tools devtools electron llm macos-app observability open-source session-viewer token-usage typescript
Last synced: 13 days ago
JSON representation
The missing DevTools for Claude Code — inspect session logs, tool calls, token usage, subagents, and context window in a visual UI. Free, open source.
- Host: GitHub
- URL: https://github.com/matt1398/claude-devtools
- Owner: matt1398
- License: mit
- Created: 2026-02-07T13:17:25.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-27T04:32:28.000Z (16 days ago)
- Last Synced: 2026-04-27T06:28:05.104Z (16 days ago)
- Topics: ai, ai-agent, ai-debugging, ai-tools, anthropic, claude, claude-code, claude-code-tools, debugging, desktop-app, developer-tools, devtools, electron, llm, macos-app, observability, open-source, session-viewer, token-usage, typescript
- Language: TypeScript
- Homepage: https://claude-dev.tools
- Size: 102 MB
- Stars: 3,202
- Watchers: 10
- Forks: 236
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
- awesome-claude-code - matt1398/claude-devtools - devtools?style=flat-square&logo=github) | DevTools for Claude Code: inspect session logs, tool calls, token usage, subagents | (Monitoring & Analytics)
- awesome-ai-agents - matt1398/claude-devtools - claude-devtools is an open-source debugging tool for Claude Code that provides visual inspection of session logs, tool calls, token usage, and subagents, reconstructing hidden details for enhanced ... (AI Agent Frameworks & SDKs / Multi-Agent Collaboration Systems)
README
claude-devtools
Your Claude is coding blind. See everything it did.
The debugging tool for Claude Code. Read session transcripts, inspect tool calls, track token usage — directly from the Claude Code logs on your machine.
Your browser does not support the video tag.
---
## The Problem
**Claude Code started hiding what it does.**
Since [v2.1.20](https://symmetrybreak.ing/blog/claude-code-is-being-dumbed-down/), Claude Code replaced detailed output with opaque summaries. `Read 3 files`. `Searched for 1 pattern`. `Edited 2 files`. No file paths. No content. No line numbers. The [community backlash was immediate](https://news.ycombinator.com/item?id=46978710).
But the problem goes deeper than collapsed file paths:
- **Thinking steps** — Claude's chain-of-thought reasoning is completely invisible in the terminal
- **Tool call details** — you see a one-line summary, not the actual input/output
- **Subagent activity** — agents spawn agents, but you only see the final result
- **Context window** — a three-segment progress bar with no breakdown of what's consuming your tokens
- **Team coordination** — teammate messages, task delegation, shutdown requests — all buried
The only workaround is `--verbose`, which dumps raw JSON, internal system prompts, and thousands of lines of noise. **There is no middle ground.**
## The Solution
**claude-devtools is the debugging tool for Claude Code.** It reads the Claude Code logs and session transcripts already saved to `~/.claude/` on your machine, and reconstructs *everything*.
| What the terminal hides | What claude-devtools shows |
|------------------------|---------------------------|
| `Read 3 files` | Exact file paths, syntax-highlighted content with line numbers |
| `Searched for 1 pattern` | The regex pattern, every matching file, matched lines |
| `Edited 2 files` | Inline diffs with added/removed highlighting |
| Three-segment context bar | Per-turn token attribution across 7 categories with compaction visualization |
| Collapsed subagent output | Full execution trees per agent with tool traces, tokens, duration, cost |
| Nothing about thinking | Extended thinking content, fully visible |
| `--verbose` JSON dump | Structured, filterable, navigable interface — no noise |
**Zero configuration. No API keys. No wrappers. Works with every session you've ever run.**
---
## Installation
### Homebrew (macOS)
```bash
brew install --cask claude-devtools
```
### Direct Download
| Platform | Download | Notes |
|----------|----------|-------|
| **macOS** (Apple Silicon) | [`.dmg`](https://github.com/matt1398/claude-devtools/releases/latest) | Download the `arm64` asset. Drag to Applications. On first launch: right-click → Open |
| **macOS** (Intel) | [`.dmg`](https://github.com/matt1398/claude-devtools/releases/latest) | Download the `x64` asset. Drag to Applications. On first launch: right-click → Open |
| **Linux** | [`.AppImage` / `.deb` / `.rpm` / `.pacman`](https://github.com/matt1398/claude-devtools/releases/latest) | Choose the package format for your distro |
| **Windows** | [`.exe`](https://github.com/matt1398/claude-devtools/releases/latest) | Standard installer. May trigger SmartScreen — click "More info" → "Run anyway" |
| **Docker** | `docker compose up` | Open `http://localhost:3456`. See [Docker deployment](#docker--standalone-deployment) |
---
## Key Features
### Context Reconstruction
Per-turn token attribution across 7 categories — **CLAUDE.md** (global, project, directory), **skills**, **@-mentioned files**, **tool I/O**, **thinking**, **team overhead**, **user text**. See exactly what's in the context window at any point.
### Compaction Visualization
See the moment your context hits the limit. Visualizes how context fills, compresses, and refills — so you know exactly what was lost.
### Notification Triggers
System notifications for `.env` access, tool errors, high token usage, and custom regex patterns on any field.
### Tool Call Inspector
Every tool call expanded with specialized viewers — syntax-highlighted Read calls, inline Edit diffs, Bash output, and full subagent trees.
### Team & Subagent Trees
Isolated execution trees per agent with tool traces, token metrics, duration, and cost. Nested agents render recursively.
### SSH Remote Sessions
Inspect sessions on any remote machine over SSH. Reads `~/.ssh/config`, supports agent forwarding and key auth.
### Command Palette & Multi-Pane Layout
**Cmd+K** for cross-session search. Open multiple sessions side-by-side with drag-and-drop tabs.
---
## Not a Wrapper
claude-devtools does **not** wrap, modify, or interfere with Claude Code. It reads session logs that already exist on your machine. Works with sessions from the terminal, IDEs, or any tool that uses Claude Code.
---
## Docker / Standalone Deployment
Run without Electron — in Docker, on a remote server, or anywhere Node.js runs.
```bash
docker compose up
# Open http://localhost:3456
```
Or manually:
```bash
docker build -t claude-devtools .
docker run -p 3456:3456 -v ~/.claude:/data/.claude:ro claude-devtools
```
| Variable | Default | Description |
|----------|---------|-------------|
| `CLAUDE_ROOT` | `~/.claude` | Path to the `.claude` data directory |
| `HOST` | `0.0.0.0` | Bind address |
| `PORT` | `3456` | Listen port |
The standalone server has **zero** outbound network calls. For maximum isolation: `docker run --network none -p 3456:3456 -v ~/.claude:/data/.claude:ro claude-devtools`. See [SECURITY.md](SECURITY.md).
---
## Development
Build from source
**Prerequisites:** Node.js 20+, pnpm 10+
```bash
git clone https://github.com/matt1398/claude-devtools.git
cd claude-devtools
pnpm install
pnpm dev
```
| Command | Description |
|---------|-------------|
| `pnpm dev` | Development with hot reload |
| `pnpm build` | Production build |
| `pnpm typecheck` | TypeScript type checking |
| `pnpm test` | Run all tests |
| `pnpm check` | Full quality gate (types + lint + test + build) |
---
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. Please read our [Code of Conduct](CODE_OF_CONDUCT.md).
## Security
IPC handlers validate all inputs with strict path containment checks. File reads are constrained to the project root and `~/.claude`. See [SECURITY.md](SECURITY.md).
## License
[MIT](LICENSE)