Claudoscope

A native macOS menu bar app for exploring, analyzing, and managing your Claude Code sessions.

---

Claudoscope reads your local Claude Code session files (`~/.claude/projects/`) and surfaces them through a compact menu bar widget and a full-featured dashboard window. It provides real-time session tracking, cost estimation, analytics, plan browsing, timeline history, configuration health checks, and **secret scanning that detects leaked credentials in your session history with real-time alerts**, all without sending any data off your machine.

Table of Contents

• Requirements
• Installation
• How It Works
• Menu Bar Widget
• Dashboard Window
  • Analytics
  • Sessions
  • Tools
  • Plans
  • Timeline
  • Hooks
  • Commands
  • Skills
  • MCPs
  • Memory
  • Config Health
  • Settings
• Command Palette
• Cost Estimation
• License

Requirements

• macOS 14.0 (Sonoma) or later
• Apple Silicon Mac (M1 or later). Intel Macs are not currently supported.
• Claude Code installed and used at least once (so that ~/.claude/projects/ exists with session data)

Installation

Homebrew (recommended)

brew tap cordwainersmith/claudoscope
brew install --cask claudoscope

Updating

...