robots.txt
# Claudoscope is a free, MIT-licensed open-source project. We want this content
# read, indexed, cited, and learned from. Content Signals below grant all three
# uses to every crawler. See https://contentsignals.org/
#
# search = building a search index and returning links and short excerpts.
# ai-input = using content as input to a model at inference time (RAG,
# grounding, generative search answers).
# ai-train = training or fine-tuning models.
User-agent: *
Content-Signal: search=yes, ai-input=yes, ai-train=yes
Allow: /
# AI assistants and answer engines, named explicitly.
User-agent: GPTBot
User-agent: OAI-SearchBot
User-agent: ChatGPT-User
User-agent: ClaudeBot
User-agent: Claude-User
User-agent: Claude-SearchBot
User-agent: anthropic-ai
User-agent: PerplexityBot
User-agent: Perplexity-User
User-agent: Google-Extended
User-agent: CCBot
User-agent: Applebot-Extended
User-agent: Bingbot
User-agent: cohere-ai
User-agent: Meta-ExternalAgent
Content-Signal: search=yes, ai-input=yes, ai-train=yes
Allow: /
Sitemap: https://claudoscope.com/sitemap.xml
llms.txt
# Claudoscope
> Claudoscope is a free, open-source (MIT) Claude Code session viewer for macOS. A native menu bar app, it reads Claude Code and Claude Cowork session files from local disk and turns them into a searchable 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 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.4.0 (released 2026-10-08).
- 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.
- [Changelog](https://claudoscope.com/changelog.md): every release, newest first, with dates, new features, fixes, and security changes.
- [Privacy](https://claudoscope.com/privacy.md): what the app reads, what stays on your Mac, and what this website collects.
## Compare
- [Claudoscope vs ccusage](https://claudoscope.com/compare/ccusage.md): both read the same session files. A feature table, where the cost estimates diverge and why, what maps to what for ccusage users, and when ccusage is the better choice.
## Guides
- [Where Claude Code stores your session history, and how to keep it past 30 days](https://claudoscope.com/blog/where-claude-code-stores-session-history.md): the `~/.claude/projects/` layout, the `cleanupPeriodDays` setting and its exemptions, resuming and naming sessions from the CLI, searching transcript contents, and `claude project purge`.
- [How to track Claude Code costs: /usage, the Console, ccusage, and Claudoscope](https://claudoscope.com/blog/how-to-track-claude-code-costs.md): what you are billed for on API versus subscription plans, what each of the four tools can and cannot show, and the eight reasons no estimate matches the invoice.
## Blog
- [Fleet view: every Claude Code agent on one board](https://claudoscope.com/blog/fleet-view-every-claude-code-agent-on-one-board.md): what shipped in 1.3. One board for every Claude Code session running now or in the last 24 hours: which agents need you, which are working, and how long until each prompt cache goes cold.
- [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.
