Skip to main content
BUNDL
PublishedUpdated
Claude DevTools icon

Claude DevTools

Visualise and analyse Claude Code session executions

Developer ToolsFreeReplaces LangSmith ($39/month)

Install with Homebrew

brew install --cask claude-devtools

Quick Take: Claude DevTools

4.4

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.

1

Install via Homebrew

brew install --cask claude-devtools

2

Launch and grant folder access if prompted

The app needs to read ~/.claude/ logs.

3

Open a past session

Pick a project and session; verify tool calls render.

4

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.

C

Claude Code --verbose / raw logs

Built-in but noisy; DevTools is the readable layer on top of the same data.

V

Vibe Notch (Claude Island)

Live notch HUD for session state and permissions, real-time, not forensic.

I

IDE SCM diff views

Show final code changes but not tool traces or token attribution.

C

Custom scripts on ~/.claude

DIY JSON parsing; flexible but high maintenance versus DevTools UI.

Pricing

Free / Open source

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

No. It is an independent open-source project that reads local Claude Code logs.

About the Author

Alex Chen

Senior Developer Tools Specialist

Code Editors & IDEsTerminal EmulatorsVersion Control Tools
12+ years in software development · Former senior engineer at tech startups

Expert Tips for Claude DevTools

1

Developers treat DevTools as cost accounting for agents, the first place to look when Max still feels tight.

Hands-on TestingHigh Confidence
2

Local-first design is a selling point versus SaaS analytics that would upload repo traces.

Official DocsHigh Confidence
3

When Claude Code UX hides thinking/tool I/O, third-party inspectors become table stakes, not niceties.

Hands-on TestingHigh Confidence

Related Technologies & Concepts

claude-devtoolsClaude Code~/.claude/MCPHomebrewVibe Notch
claude-devtools (Session inspection app for Claude Code), Claude Code (Upstream agent whose logs are inspected), ~/.claude/ (Local directory of session transcripts and memory), MCP (Tool protocol whose calls appear in traces), Homebrew (Common macOS install channel for the cask), Vibe Notch (Complementary real-time status utility)

Related Topics

Developer Tools

Coding agents and debuggers.

AI Assistants

Claude ecosystem apps.

Sources & References

Fact-Checked

Last 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]
  1. 1
    claude-devtools official site

    Accessed Aug 9, 2026

    "Product pitch, features, brew install, 50k+ developers."

  2. 2
    claude-devtools GitHub

    Accessed Aug 9, 2026

    "Source, releases, MIT license."

  3. 3
    Claude Code product

    Accessed Aug 9, 2026

    "Upstream agent DevTools inspects."

  4. 4
    Claude pricing (usage context)

    Accessed Aug 9, 2026

    "Why token visibility matters for Pro/Max users."

  5. 5
    Homebrew cask install line

    Accessed Aug 9, 2026

    "brew install --cask claude-devtools documented on site."

  6. 6
    Claude 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

Compare Claude DevTools

Claude DevTools is a Free Alternative

Claude DevTools can replace these paid apps:

Browse all free alternatives

More Developer Tools

View all

Featured in Collections

Explore More on Bundl

Related Reading

Compare Claude DevTools

Free Alternatives

Similar Apps

Read our complete guide to the best developer tools for Mac