Claude Code usage
Clauditor
Stop Claude Code from burning through your quota in 20 minutes. Auto-rotates oversized sessions and preserves context.
Install
npx @iyadhk/clauditor installFound in the project README. Check it for setup steps after installing.
git clone https://github.com/IyadhKhalfallah/clauditor.gitFrom the README
clauditor
Stop Claude Code from burning through your quota in 20 minutes.
The problem
Every turn in a Claude Code session re-sends your entire conversation history to the API. A fresh session sends ~20k tokens per turn. A 200-turn session sends ~200k per turn. Same work, 10x more quota.
This is why your session limit gets hit in 20 minutes. Not because of a bug — because sessions grow linearly and nobody tells you to start fresh.
The solution
clauditor monitors your session size and blocks Claude when you're wasting quota, saving your progress so you can start fresh without losing context.
When you type "continue" in the new session, clauditor shows your saved sessions and tells you exactly what to type:
Install
Or via npm:
That's it. Two commands. clauditor registers hooks into Claude Code and runs in the background. No dashboard needed. No config needed.
Also works with npx (no global install):
Hooks are registered to run via npx automatically.
New hooks are auto-registered on upgrade — no need to re-run clauditor install.
Requires Node.js 20+.
Supported platforms: Claude Code CLI, VS Code extension, JetBrains extension. Does not work with Claude Code on the web (claude.ai/code).
Known limitation: The "continue" prompt block works reliably in the CLI. In the VS Code extension, the UserPromptSubmit hook may not fire consistently — context is still injected via SessionStart but Claude may not always announce it. This is a Claude Code bug, not a clauditor issue.
How it works
clauditor registers 7 hooks into Claude Code:
UserPromptSubmit — blocks before tokens are wasted
Before Claude processes your prompt, clauditor checks two things:
1. Waste factor — if the session is burning too much quota, it blocks with exit code 2.
2. "Continue" detection…Details
- Repository
- IyadhKhalfallah/clauditor
- Language
- TypeScript
- License
- MIT
- Last updated
- 16 April 2026
- Topics
- claude-codeclihookstoken-optimization
FAQ
What is Clauditor?
Stop Claude Code from burning through your quota in 20 minutes. Auto-rotates oversized sessions and preserves context. It is a usage for Claude Code, from IyadhKhalfallah/clauditor on GitHub.
How do I install Clauditor?
Run npx @iyadhk/clauditor install, then follow the setup in the README.
Is Clauditor popular?
IyadhKhalfallah/clauditor has 430 GitHub stars and 44 forks. It was last updated on 16 April 2026.
More usage & cost trackers
Claude Lens
253foyzulkarim/claude-lens
Local dashboard visualising Claude Code sessions, token costs, cache performance and tool calls.
Klaatcode
353KlaatAI/klaatcode
Open-source AI coding agent for the terminal. Claude Code-grade accuracy with smart model routing — uses the right AI model for each task, cutting costs 10x. Supports Claude, GPT, Gemini, DeepSeek & more.
tare
303kelviq/tare
Audits Claude Code session logs to explain where your usage and limits went.
CursorLens
402HamedMP/CursorLens
An open-source dashboard for Cursor.sh IDE. Log AI code generations, track usage, and control AI models (including local ones). Run locally or use upcoming hosted version.
Clawmetry
436vivekchand/clawmetry
See your agent think. Zero-config observability & governance for 30 AI agent runtimes: Claude Code, OpenAI Codex, Hermes, OpenClaw & 26 more. Live token costs, sessions, tool calls, crons.
Myrlin Workbook
389therealarthur/myrlin-workbook
Open-source workspace manager for AI coding CLIs: Claude Code and ChatGPT Codex in one browser app. Discovers every session on disk, embedded terminals, phone-ready, cost tracking, kanban, docs. Windows, macOS, Linux.
Browse the most popular Claude Code mods, all usage & cost trackers, or the skills and MCP server directories.