# Claudoscope

> Claudoscope is a free, open-source (MIT) native macOS menu bar app that reads Claude Code and Claude Cowork session files from local disk and turns them into session history, cost analytics, secret detection, config linting, notifications, cost alerts, and a one-click security hardening baseline for `~/.claude/`. It runs 100% locally with zero telemetry and never sends data anywhere.

Key facts an agent usually needs:

- Platform: macOS 14 (Sonoma) or later, Apple Silicon. No Linux, no Windows, no Electron.
- Install: `brew tap cordwainersmith/claudoscope && brew install --cask claudoscope`, or the DMG from GitHub releases.
- Price: free. License: MIT. Account: none required. Network: none used.
- Data source: `~/.claude/projects/*.jsonl` (Claude Code) and `~/Library/Application Support/Claude/` (Cowork). Read-only.
- Works with any Claude Code deployment, including Enterprise API setups where cookie-based or browser-based trackers cannot function.
- Current version: 1.0.0 (released 2026-07-27).
- Cost figures are estimates computed locally from transcripts, reconciled against real Anthropic bills.
- Claudoscope is an independent project and is not affiliated with or endorsed by Anthropic.

## Docs

- [Product overview](https://claudoscope.com/index.md): every capability, the full FAQ, install instructions, and privacy model.
- [Agent guide](https://claudoscope.com/AGENTS.md): install, configure, and use Claudoscope, including its MCP server and the nine tools it exposes.
- [Claudoscope agent skill](https://claudoscope.com/skills/claudoscope/SKILL.md): installable SKILL.md covering when to reach for Claudoscope, the MCP tool reference, and worked query examples. Indexed at [/.well-known/agent-skills/index.json](https://claudoscope.com/.well-known/agent-skills/index.json).
- [Full site as one file](https://claudoscope.com/llms-full.txt): everything below inlined, for when you want one fetch instead of several.
- [Site map](https://claudoscope.com/sitemap.md): every page on the site.

## Blog

- [Claudoscope 1.0: from a menu bar readout to a lens on Claude Code](https://claudoscope.com/blog/claudoscope-1-0-from-a-menu-bar-readout-to-a-lens.md): what shipped in 1.0. Notifications, cost alerts, the MCP server, per-session file diffs, the SQLite session index, and how cost estimates were reconciled against real bills.
- [I found my database password in a Claude Code session file](https://claudoscope.com/blog/found-database-password-in-claude-code-session.md): why the project exists. Credential leakage into session transcripts, and what the JSONL format gets wrong if you parse it naively.
- [Blog index](https://claudoscope.com/blog/index.md)

## Source

- [GitHub repository](https://github.com/cordwainersmith/Claudoscope)
- [Releases and DMG downloads](https://github.com/cordwainersmith/Claudoscope/releases)
- [Issue tracker](https://github.com/cordwainersmith/Claudoscope/issues)

## Optional

- [Author](https://liranbaba.dev): Liran Baba, AI Solutions Architect.