Claude Code usage

Clauditor

Stop Claude Code from burning through your quota in 20 minutes. Auto-rotates oversized sessions and preserves context.

430 stars 44 forksUsage & cost trackers Source

Install

Install
npx @iyadhk/clauditor install

Found in the project README. Check it for setup steps after installing.

From source
git clone https://github.com/IyadhKhalfallah/clauditor.git

From 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…
Read the full README on GitHub

Details

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

Browse the most popular Claude Code mods, all usage & cost trackers, or the skills and MCP server directories.