Claudoscope
Liran Baba · Browse, analyze and monitor Claude Code and Cowork sessions from the macOS menu bar.
Claudoscope is a Developer Tools app for Mac. It needs macOS 14 or later.
About
Claudoscope is a free, MIT-licensed native macOS session dashboard. It reads local Claude Code and Cowork records, with conversation search, per-message token and cost estimates, file diffs, Trace timeline replay, bookmarks and terminal resume. Fleet shows running and waiting sessions; analytics summarizes project, model and cache usage. Optional notifications, spend alerts, local credential scanning and reversible security hardening are also available. Costs are estimates, not billing records. Session content is processed locally; update checks use the network.
Installation
Requires Apple Silicon (M1 or later) and macOS 14 or later; Intel is not currently supported. Install and use Claude Code at least once so ~/.claude/projects/ contains session data. With Homebrew installed, run the commands below, then open Claudoscope from Applications. Alternatively download the official release DMG, open it and drag the app into Applications.
brew install --cask claudoscope
Updating
brew upgrade --cask claudoscope
https://claudoscope.com/ https://github.com/cordwainersmith/Claudoscope/releases
New What’s new in 1.4.0 Oct 8 · OpenNavo editorial · Translated
Session viewer release: Trace, Replay, share cards, minimap, bookmarks and terminal resume; lower CPU and memory use and corrected model pricing.
Install and uninstall
Homebrew installs the app in your Applications folder.
Install without Homebrew
Download the same file Homebrew uses: github.com/cordwainersmith/Claudoscope/releases/download/v1.4.0/Claudoscope.dmg
SHA-256 only checks that the download is complete; it is not a security certification. See the SHA-256 and download address
$ brew uninstall --cask \claudoscopeA regular uninstall removes the app and keeps its settings and caches.
$ brew uninstall --zap --cask \claudoscope--zap also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left.See which files are removed
Facts and sources
- Version 1.4.0
- Recorded by Homebrew on Oct 11Released by the vendor on Oct 8
Questions
Is Claudoscope safe?
Claudoscope is in Homebrew’s official catalog and has not been disabled. Since September 2026, Homebrew disables apps that fail macOS Gatekeeper checks. When installing, Homebrew checks the download from github.com against its SHA-256 checksum. It was installed 90 times through Homebrew in the last 30 days.
Is Claudoscope open source?
Claudoscope’s source code is public on GitHub (cordwainersmith/Claudoscope) under the MIT license.
How do I completely uninstall Claudoscope on a Mac?
Run brew uninstall --cask claudoscope. It quits the app. To delete its settings and caches as well, run brew uninstall --zap --cask claudoscope. That also deletes 4 files and folders, including ~/.
Does Claudoscope run on Apple silicon (M1 and later) Macs?
Yes, and only there: it does not install on Intel Macs. It needs macOS 14 or later.
Where does Claudoscope store its settings and data?
Its settings are in ~/. Its data is in ~/. These locations come from Homebrew’s clean-up list.
What is the latest version of Claudoscope?
The latest version is 1.4.0, added to Homebrew on Oct 11. Claudoscope updates itself; to update it with Homebrew, run brew upgrade --cask --greedy claudoscope.