IyadhKhalfallah

IyadhKhalfallah / clauditor

Public

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

www.npmjs.compackage@iyadhkclauditor claude-code cli hooks token-optimization
19
0
100% credibility
Found Apr 03, 2026 at 19 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

Clauditor monitors AI coding sessions to detect quota waste from growing conversation history and prompts users to rotate sessions while preserving context.

How It Works

1
😩 Hit quota limits fast

You're using your AI coding helper but notice sessions burn through your usage allowance in just 20 minutes.

2
🔧 Set up clauditor

Follow two simple steps to add a quota-saving watcher that runs quietly in the background.

3
👀 Watch sessions grow

It tracks how much each chat turn costs compared to the start, showing you exactly when things get wasteful.

4
💻 Keep coding normally

Use your AI assistant as usual while it monitors for problems like repeating loops or full memory.

5
🚨 Get smart alerts

When a session wastes too much, it pauses, saves your work, and suggests starting fresh with all context intact.

✅ Save quota and continue

Your sessions stay efficient, you avoid surprise limits, and pick up right where you left off feeling in control.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 19 to 19 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is clauditor?

Clauditor is a TypeScript CLI tool that hooks into Claude Code (CLI, VS Code, JetBrains) to monitor session token usage and auto-block oversized conversations before they burn your Anthropic quota. Sessions grow linearly—20k tokens/turn at start balloons to 400k+ after 500 turns—clauditor detects this "waste factor," saves branch/files/turns state, and forces a fresh session while injecting context automatically. Install with `npm i -g @iyadhk/clauditor && clauditor install`; commands like `clauditor watch` give live dashboards, `clauditor sessions` show historical quota sinks.

Why is it gaining traction?

It solves the "20-minute quota burnout" devs hit with Claude Code agents, where history resends every turn—no alternatives auto-rotate while preserving context via hooks like PreCompact/SessionStart. Features like cache degradation alerts, loop blocking, bash output compression, and cost estimates (~$645/session saved) make quota tracking actionable. Unlike manual resets, it nudges Claude to suggest fixes inline, stopping code execution waste without disrupting flow.

Who should use this?

Claude Code heavy users on Max plans building agentic apps, like backend devs iterating .NET services (889-turn sessions) or fixing tests. Ideal for those tired of stop Claude code from asking permission mid-loop or stop Claude subscription drains from unmonitored autonomy—frontend/fullstack hitting limits on file edits/Bash runs.

Verdict

Try it if Claude Code quotas kill your workflow—solid docs, 48 tests, MIT license, but 19 stars and 1.0% credibility signal early stage; watch for hook stability. At $0 setup, it pays off fast for 100+ turn sessions.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.