Claude DevTools
Visualise and analyse Claude Code session executions
Install with Homebrew
brew install --cask claude-devtoolsQuick Take: Claude DevTools
Claude DevTools is the missing X-ray for Claude Code on Mac: free, local, and focused on tool traces and tokens. Install it if you run agents daily or debug cost spikes; skip it if Claude Code is an occasional toy. Keep expectations clear: it observes and explains; it does not replace Anthropic's agent.
Best For
- •Daily Claude Code users optimising prompts and cost
- •Leads reviewing agent behaviour
- •Security-conscious devs watching sensitive path access
- •Mac users with remote Linux devboxes via SSH
What is Claude DevTools?
Claude DevTools (also styled claude-devtools) is an open-source desktop inspector for Claude Code sessions. It does not wrap or replace Claude Code. Instead it reads the session logs already stored under ~/.claude/ on your machine and reconstructs what the agent actually did: thinking steps, tool calls, diffs, subagent trees, token attribution, and project memory files.
Why it exists: as Claude Code matured, terminal UI sometimes collapsed rich traces into opaque summaries. Community backlash against "coding blind" experiences led to tools that restore visibility without forcing --verbose JSON spam. As of August 2026 the project markets itself to 50,000+ developers, ships macOS (Apple Silicon and Intel), Windows, and Linux builds, and installs on Mac via brew install --cask claude-devtools. It is MIT licensed, requires no API keys, and makes zero outbound calls for core inspection. That privacy posture suits developers who dislike SaaS log uploads.
Pricing is free. There is no premium tier. You already pay Anthropic for Claude Code usage; DevTools only visualises local artifacts.
Relationship to other tools: complementary to Vibe Notch / Claude Island (live status) rather than competing. DevTools is forensic and analytical after or during sessions; notch apps are real-time HUDs. It is not an official Anthropic product, though it is tightly coupled to Claude Code log formats and must track upstream changes.
On Mac, the app is a practical companion for anyone on Pro/Max who wants to understand token burn, debug why an agent went sideways, or compare two prompt strategies side by side. If you only run Claude Code once a month, you may not need it. If Claude Code is daily infrastructure, DevTools quickly pays for itself in saved confusion, at $0 software cost.
For teams, Claude DevTools becomes a coaching instrument: leads can open a junior's session (with consent and local access) and show exactly where the agent reread the same failing test fifty times. That teaching moment is hard to recreate from a final git diff alone. In consulting settings, DevTools also helps justify invoices. You can show that a day of agent work touched the right services rather than thrashing unrelated packages.
Technical caveats worth repeating: because the tool depends on on-disk log schemas, a Claude Code upgrade can temporarily break parsing until DevTools ships a matching release. Keep both tools reasonably current. If you encrypt home directories or use unusual Claude config locations, point the app at the correct paths. On managed Macs, ensure endpoint security tools do not quarantine the app when it reads many small session files quickly.
Feature depth in practice: context reconstruction charts often reveal that half of a '200k context' feeling is tool output residue and repeated file reads, not your carefully written prompts. Cleaning CLAUDE.md and adding ignore patterns can cut costs more than switching from Opus to Sonnet. Subagent trees similarly show whether parallelisation helped or merely multiplied confusion. Notification triggers on.env access are the closest thing to a runtime seatbelt DevTools offers, configure them before the first untrusted repo experiment.
Comparison with simply using jq on JSONL logs: scripts are fine for one-off forensics, but DevTools wins for daily navigation, multi-pane compare, memory browsing, and SSH remote hosts. Comparison with IDE local history: IDEs show code evolution, not why the agent chose a tool sequence. You want both. Comparison with Anthropic's official UIs: official products optimise for doing work; DevTools optimises for understanding work already done. In short, if Claude Code is part of your daily Mac craft, Claude DevTools is the observability pane you will eventually install anyway, better to install it before the first mysterious Max invoice or the first baffling wrong refactor you cannot explain to a teammate.
Closer look: Observability for coding agents
Agentic coding without traces is ops without metrics. You can always grep JSONL with jq for a one-off autopsy, but day-to-day work is faster in DevTools: multi-pane compare, memory browsing, and SSH remote hosts without reinventing the viewer each time. IDE local history answers what the code looked like over time; it does not explain why the agent picked a tool sequence. Keep both. Anthropic's own products are built to get work done; this inspector is built to understand work that already happened.
History & Background
As Claude Code grew more agentic, terminal brevity conflicted with power-user needs. DevTools emerged to decode on-disk logs.
How It Works
Reader over local session storage; UI for transcripts, trees, and token charts; optional SSH transport for remote homes.
Ecosystem & Integrations
Sits beside Claude Code, IDEs, and notch HUDs. Competes mainly with DIY scripts.
Future Development
Track upstream log schema changes; deeper cost charts; tighter IDE deep links.
Key Features
Session transcript browser
Open any historical Claude Code session from disk and scroll human-readable messages instead of raw JSONL.
Tool call inspector
Expand Read/Edit/Bash/Grep calls with syntax highlighting and inline diffs, the opposite of a collapsed "Read 3 files" summary.
Context reconstruction
Per-turn token attribution across categories such as CLAUDE.md, skills, @-files, tool I/O, thinking, and user text so you see what filled the window before compaction.
Subagent and team trees
Visualise nested agents with their own token, duration, and cost metrics.
Project memory pane
Browse ~/.claude/projects/./memory layers with markdown rendering and open-in-editor hooks for Cursor, VS Code, Zed, Xcode, and popular terminals.
Notifications and triggers
Alerts for.env access, tool errors, high token use, and custom regex on sensitive paths.
SSH remote sessions
Inspect ~/.claude on remote machines over SSH using your local UI. Handy for cloud devboxes from a Mac laptop.
Multi-pane compare
Open two sessions side by side to A/B prompt strategies with real history rather than vibes.
Command palette search
Cmd+K style search across sessions with highlighted snippets to jump to exact messages.
Copy-friendly rendering
Selectable text without terminal ANSI pain, copy paths, code blocks, and responses cleanly on Mac.
Who Should Use Claude DevTools?
1Cost-conscious freelancer
After a $40 API day, opens DevTools, finds a loop of failed tests re-read 200 times, and rewrites the prompt/CLAUDE.md to stop the thrash.
2Tech lead
Reviews juniors' agent sessions to teach better task slicing without shoulder-surfing their terminals live.
3Security-minded engineer
Sets triggers on.env and payment path touches to get notified when an agent sniffs secrets.
4Remote-dev Mac user
SSHs DevTools into a Linux workstation's Claude logs while coding on a MacBook at a café.
5Open source maintainer
Inspects agent sessions that prepared a release PR to ensure changelog generation did not hallucinate closed issues.
How to Install Claude DevTools on Mac
Homebrew cask is the path of least resistance on macOS.
Install via Homebrew
brew install --cask claude-devtools
Launch and grant folder access if prompted
The app needs to read ~/.claude/ logs.
Open a past session
Pick a project and session; verify tool calls render.
Optional: configure notification triggers
Add regexes for sensitive paths before your next long agent run.
Pro Tips
- • Install Claude Code and generate at least one session before expecting data.
- • Prefer Apple Silicon.dmg from releases if you avoid Homebrew.
- • Keep the app updated when Claude Code changes log formats.
Configuration Tips
Baseline a "good" session
Save a clean successful session as a comparison golden when tuning prompts.
Alert on secrets paths early
Configure.env and credentials globs before running agents on unfamiliar repos.
Use split panes for prompt A/B
Run two strategies on the same bug in separate worktrees, then compare trees.
Alternatives to Claude DevTools
Visibility and debugging options around Claude Code.
Claude Code --verbose / raw logs
Built-in but noisy; DevTools is the readable layer on top of the same data.
Vibe Notch (Claude Island)
Live notch HUD for session state and permissions, real-time, not forensic.
IDE SCM diff views
Show final code changes but not tool traces or token attribution.
Custom scripts on ~/.claude
DIY JSON parsing; flexible but high maintenance versus DevTools UI.
Pricing
Claude DevTools is free (MIT). No subscription, no API key, no cloud account. Costs are only your time and whatever you already spend on Claude Code/API.
Pros
- ✓Restores visibility Claude Code terminal summaries remove
- ✓Free, local-first, no API keys
- ✓Excellent token and subagent forensics for cost control
- ✓SSH remote inspection from Mac
- ✓Homebrew cask makes updates easy
- ✓Complements notch status tools without overlapping
Cons
- ✗Unofficial, can break when Claude Code log formats change
- ✗Does not prevent bad agent actions in real time (mostly inspects)
- ✗Another Electron-or-desktop app in the dock for minimalists
- ✗Requires existing ~/.claude history to be useful
- ✗Not a substitute for Anthropic's official product support
Community & Support
Project site claude-dev.tools and GitHub matt1398/claude-devtools host releases and issues. Threads spike on HN and X whenever Claude Code's terminal UX hides detail people needed. Support is classic OSS: open an issue and attach the log format version you are on. Engineering managers use the inspector in 1:1 coaching (with consent and local access) to walk a junior through the exact loop where the agent re-read one failing test dozens of times; a merged git diff rarely shows that path. Consultants lean on the same timeline when clients ask what a day of agent work actually touched, which services moved, and which packages were left alone.
Frequently Asked Questions about Claude DevTools
About the Author
Expert Tips for Claude DevTools
Developers treat DevTools as cost accounting for agents, the first place to look when Max still feels tight.
Local-first design is a selling point versus SaaS analytics that would upload repo traces.
When Claude Code UX hides thinking/tool I/O, third-party inspectors become table stakes, not niceties.
Related Technologies & Concepts
Related Topics
Sources & References
Fact-CheckedLast verified: Aug 9, 2026
Key Verified Facts
- Claude DevTools installs on macOS via brew install --cask claude-devtools and reads local ~/.claude logs.[cite-1, cite-5]
- The tool is free, open source, and marketed as requiring no API keys with local session inspection.[cite-1, cite-2]
- Features include tool call inspection, context reconstruction, subagent trees, and SSH remote session viewing.[cite-1]
- 1claude-devtools official site
Accessed Aug 9, 2026
"Product pitch, features, brew install, 50k+ developers."
- 2
- 3
- 4
- 5Homebrew cask install line
Accessed Aug 9, 2026
"brew install --cask claude-devtools documented on site."
- 6Claude Code ecosystem companions discussion context
Accessed Aug 9, 2026
"Community backlash context referenced by DevTools marketing around terminal opacity."
Research queries: claude-devtools brew install; Claude Code session inspector; claude-dev.tools