token-doctor

Official

Diagnose and optimize your Claude token spend.

Authortechwolf-ai
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Claude Code and Codex transcripts can hide cost drivers and session inefficiencies. token-doctor provides a local, two-stage diagnosis of spending by analyzing transcripts, projecting per-project spend, and offering a deeper Haiku-based investigation with parallel subagents to reveal actionable improvement opportunities.

Core Features & Use Cases

  • Two-stage diagnosis: quick terminal report plus optional hotspot deep dives.
  • Per-project spend insights: identify which cwd/project carries the most cost, marathon vs zombie vs cache rebuilds.
  • Generates a Markdown report for sharing, auditing, and archival.

Quick Start

Run the token-doctor on your local Claude transcripts to generate a cost diagnosis.

Dependency Matrix

Required Modules

None required

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: token-doctor
Download link: https://github.com/techwolf-ai/ai-first-toolkit/archive/main.zip#token-doctor

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 510,000+ vetted skills library on demand.