{"id":51034029,"url":"https://github.com/mbailey/ccexplorer","last_synced_at":"2026-06-22T03:31:02.493Z","repository":{"id":357035556,"uuid":"1235042681","full_name":"mbailey/ccexplorer","owner":"mbailey","description":"Cost Explorer for Claude Code","archived":false,"fork":false,"pushed_at":"2026-05-12T00:10:27.000Z","size":59,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-05T11:04:04.801Z","etag":null,"topics":["analysis","claude-code","cost"],"latest_commit_sha":null,"homepage":"https://ccexplorer.dev","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mbailey.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-11T00:39:41.000Z","updated_at":"2026-05-25T08:56:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mbailey/ccexplorer","commit_stats":null,"previous_names":["mbailey/ccexplorer"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/mbailey/ccexplorer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbailey%2Fccexplorer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbailey%2Fccexplorer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbailey%2Fccexplorer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbailey%2Fccexplorer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mbailey","download_url":"https://codeload.github.com/mbailey/ccexplorer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbailey%2Fccexplorer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34633796,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-22T02:00:06.391Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analysis","claude-code","cost"],"created_at":"2026-06-22T03:31:02.427Z","updated_at":"2026-06-22T03:31:02.488Z","avatar_url":"https://github.com/mbailey.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ccexplorer\n\n**Local-first Cost Explorer for Claude Code sessions.** Walks\n`~/.claude/projects/\u003cproject\u003e/\u003csession\u003e.jsonl`, aggregates token usage,\nand renders an AWS-Cost-Explorer-style interactive HTML report so you\ncan slice your spend by **tool, project, session, model, and time**.\n\n\u003e **Status: alpha** -- v0.0.1 ships the `cce build` static-HTML path.\n\u003e CLI query subcommands (`get-cost-and-usage`, `get-dimension-values`)\n\u003e and the Trusted-Advisor-style recommendations engine are next.\n\n\u003cimg width=\"2245\" height=\"1442\" alt=\"image\" src=\"https://github.com/user-attachments/assets/b0a7575c-c181-4717-9e34-d6b6d03921c7\" /\u003e\n\n\n## Why\n\nccusage already does cost calculation well. ccexplorer adds two things\nthe existing tools don't:\n\n1. **Tool/agent attribution.** Apportions each assistant turn's cost\n   across its `tool_use` blocks so you can see *which tools* the money\n   actually went to (and how much went to non-tool conversation).\n2. **A slice-and-dice surface.** Same query model as AWS Cost\n   Explorer -- time-period x granularity x metrics x group-by x filter\n   -- so you can answer questions like \"today's voicemode tool calls,\n   grouped by session\" without writing SQL.\n\nA recommendations engine (\"Trusted Advisor for Claude Code\") is the\nnext layer on top -- top-N tool over-use, repeat-read detection,\ncache-write premium, etc.\n\n## Privacy\n\n100% local. The tool never makes a network call. The report is a\nsingle HTML file with your data embedded as JSON; it loads\n[Chart.js](https://www.chartjs.org/) from a CDN but nothing else\nleaves your machine.\n\n## Install\n\n```bash\n# Zero-install run\nuvx ccexplorer\n\n# Or install persistently\npip install ccexplorer\n```\n\n## Usage\n\n```bash\n# Walk ~/.claude/projects, build /tmp/cce.html, open it in your browser\ncce build\n\n# Custom output path, no browser launch\ncce build --output ~/cce-report.html --no-open\n\n# Different projects root (rarely needed)\ncce build --projects-root /path/to/.claude/projects\n```\n\nRun with no subcommand and you get `cce build` with default flags --\nthe \"just show me the pretty thing\" path.\n\n## What the report shows\n\n* Total spend, with breakdowns by tool, project, session, model, and day\n* Tool vs non-tool token-cost split (often surprising -- ~50% of long\n  sessions is non-tool conversation)\n* Cache-write / cache-read / input / output split (cache writes are\n  often the largest line item on Opus sessions)\n* AWS-Cost-Explorer-style sidebar: time-range presets (1d / 7d / 30d /\n  All), group-by dropdowns, filter chips, advanced toggles\n\n## Roadmap\n\n* [ ] `cce get-cost-and-usage` (CLI flagship, mirrors `aws ce`)\n* [ ] `cce get-dimension-values` (enumerate tools / projects / models)\n* [ ] AGENT dimension (extract sub-agent type from `Agent` tool calls)\n* [ ] TAG support (sidecar `\u003csession\u003e.tags.json` or `cce tag` command)\n* [ ] COST_CATEGORY rules engine\n* [ ] `cce serve` (live local server, no rebuild on every change)\n* [ ] `cce advise` -- recommendations engine\n\n## Acknowledgements\n\nIdea and voice-spec: [Mike Bailey](https://failmode.com)\n([@mbailey](https://github.com/mbailey)) -- including the $46k of\nhis own session data we validated against. Research, prototype,\nwrite-up: Cora 7. A \"How this got built\" page is forthcoming -- this\nproject is transparent about its AI-pair-programming origin.\n\n## License\n\n[MIT](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmbailey%2Fccexplorer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmbailey%2Fccexplorer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmbailey%2Fccexplorer/lists"}