cordwainersmith

cordwainersmith / Claudoscope

Public

native macOS app that gives you a real-time dashboard for your Claude Code sessions, with analytics, conversation history, and project insights.

10
1
100% credibility
Found Mar 18, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

Claudoscope is a macOS menu bar app that locally analyzes Claude Code session files to provide real-time usage stats, cost estimates, chat histories, configuration linting, and secret detection.

How It Works

1
🔍 Discover Claudoscope

While using your AI coding companion on Mac, you hear about a handy menu bar tool that tracks your sessions and spots issues.

2
📥 Install easily

Grab it with a quick Homebrew command or download the app file and drop it in Applications.

3
⭐ Spot it in menu bar

A small icon appears in your menu bar, ready to give you a quick peek at your work.

4
📊 See today's stats

Click the icon for instant view of sessions, tokens used, costs, and recent chats – all local and private.

5
🪟 Open dashboard

Hit the dashboard button to explore full analytics, chat histories, plans, and health checks.

6
🛡️ Check for secrets

Scan configs and sessions for leaked passwords or keys with real-time alerts to stay secure.

✅ Master your AI coding

Save money on usage, fix config issues, and keep secrets safe – your coding sessions run smoother than ever.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is Claudoscope?

Claudoscope is a native macOS app built in Swift that delivers a real-time dashboard for your Claude Code sessions, pulling data from local `~/.claude/projects/` files. It shows analytics on token usage and costs, full conversation histories, project breakdowns, and config health checks—all without sending data off-machine. Menu bar widget gives quick stats like today's tokens and active sessions, while the full window offers charts, timelines, and secret scanning alerts.

Why is it gaining traction?

It stands out with proactive features like real-time secret detection in session tails (AWS keys, API tokens) and linting for CLAUDE.md, rules, and skills to catch config issues early. Cost estimates factor in Anthropic or Vertex pricing tiers accurately, and FSEvents watching ensures instant updates without polling. For Claude Code power users, this native macOS analytics layer beats digging through JSONL files manually.

Who should use this?

Claude Code developers on macOS tracking heavy session usage across projects, especially those burning tokens on Opus/Sonnet and needing cost oversight or leaked credential alerts. Ideal for teams auditing configs for lint errors in skills/rules or monitoring idle sessions to optimize workflows.

Verdict

Worth installing via Homebrew for active Claude Code users—solid native macOS execution despite 10 stars and 1.0% credibility score signaling early alpha status (automerge not enabled, light testing). Maturity lags with sparse docs, but local-only design and sharp UI make it a keeper for session analytics.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.