$ account cordwainersmith
Claudoscope is a native macOS menu-bar application that serves as an observability and configuration management dashboard for Claude Code, Anthropic's AI coding assistant. It reads local Claude Code session transcripts (JSONL), caches parsed summaries in a GRDB-backed SQLite store, and presents analytics on token usage, cost, cache effectiveness, model distribution, and attribution per skill, MCP tool, or agent. The app also includes a comprehensive configuration linter (100+ rules for security, skills, hooks, routing, hardening, and more), an installer for Claude Code hardening baselines and agent routing stacks, real-time file monitoring via FSEvents, and an optional MCP server that exposes read-only tools for AI-driven querying. It operates as a background agent with a menu bar popover and a full dashboard window. The application is built as a monolithic SwiftUI macOS app with modular service actors, extensive unit tests (60+ test files), and a clean separation of concerns. Key entry points include the session parser, analytics engine, linter service, and installer file operations. It depends on Claude Code's local file structure and specific JSONL schemas, which drives a medium technical drift risk as those formats evolve. The codebase demonstrates high craftsmanship with reusable patterns such as pure analytic functions, atomic configuration writers, and a design token system, making it a strong example of a well-engineered developer tool.