nadimtuhin

    nadimtuhin/claude-token-optimizer

    Cut the tokens Claude Code loads at session start. CLI that sets up a small CLAUDE.md with on-demand docs, measures startup tokens, and keeps them small.

    automation
    developer-tools
    documentation
    agents-md
    ai-assistant
    claude
    claude-code
    claude-md
    JavaScript
    MIT
    643 stars
    85 forks
    643 GitHub watchers
    Updated Nov 2, 2026
    View on GitHub

    Build with Backblaze B2

    SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.

    Explore Backblaze Labs

    Loading star history...

    Where it stands

    Rank, growth pace and release cadence relative to everything GStars tracks.

    The project lists 2 contributors on GitHub.

    Use Cases & Benefits

    • Optimizes token usage for Claude API calls by structuring documentation to load only essential context.
    • Reduces token consumption by up to 90%, freeing context space for relevant code and improving Claude's efficiency.
    • Use for minimizing token waste in AI-assisted coding sessions to keep context focused on current code.
    • Use for auto-detecting and applying framework-specific documentation patterns to optimize token loading.
    • Use for integrating token usage monitoring and management hooks into CI pipelines for continuous documentation health.

    Should you depend on it?

    License terms, project hygiene and risks, from GitHub metadata and GStars' snapshots.

    License

    MIT

    Permissive: commercial use, modification and redistribution are allowed with attribution.

    Community files

    • README: present
    • Contributing guide: present
    • Code of conduct: present

    Watch-outs

    • Owned by an individual account with only 2 contributors on GitHub; plan for bus-factor risk.
    • No GitHub releases; pin a commit or tag instead of a release.

    General guidance from repository metadata, not legal advice. How we score

    From the README

    Stop wasting Claude Code's context on old docs

    Cut token usage by 90% so Claude can focus on your actual code

    Claude Code loads everything at session start. My RedwoodJS project was burning 11,000 tokens before I even started coding - that's 1,783 lines of documentation, old session notes, and completed task history eating into my context window.

    Structure your docs so Claude only loads what it needs:

    Real result: 11,000 → 1,300 tokens. That's 9,700 tokens freed up for your code.

    Excerpt from the nadimtuhin/claude-token-optimizer README on GitHub (MIT license). © its authors.Read the full README on GitHub

    Daily snapshots

    Stars gained per day, and how forks and open issues moved, from GStars' daily snapshots

    Forks

    85+18

    Open issues

    12+3

    Compared with peers in Automation

    Fastest-growing repositories GStars tracks in this cohort for the week of Nov 1, by 7-day star growth

    nadimtuhin/claude-token-optimizer compared with Automation repositories by stars, 7-day star growth, health score and last release
    RepositoryStars+7dHealthLast release
    vercel-labs/agent-desktop17.0K+13.3K33today
    D4Vinci/Scrapling98.1K+6.9K651 day ago
    Panniantong/Agent-Reach109.3K+3.0K604 days ago
    lexmount/moli22.7K+1.2K552 days ago
    superplanehq/superplane8.8K+435607 days ago
    nadimtuhin/claude-token-optimizer643—17—
    Category median22.7K+3.0K60—

    Discover Repositories

    Search across tracked repositories by name or description