Astro-Han

Astro-Han / claude-lens

Public

Claude Code statusline with pace tracking. Shows remaining quota + whether you should slow down. Bash + jq. ~165 lines.

bash claude claude-code cli developer-tools
12
0
100% credibility
Found Mar 20, 2026 at 12 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

Claude Lens is a simple add-on script that enhances the status bar in Claude Code to display usage pace, quotas, context size, project info, and changes for better session management.

How It Works

1
🔍 Discover Claude Lens

While using your AI coding helper called Claude Code, you learn about a simple tool that makes the status bar smarter and more helpful.

2
📥 Download the script

You grab the tiny helper script with one quick command and save it to a folder on your computer.

3
⚙️ Connect it to Claude Code

You tell Claude Code to use this new status bar by setting a simple preference.

4
🔄 Restart Claude Code

You restart your coding helper, and it picks up the new status bar right away.

5
📊 Watch the status bar light up

A colorful progress bar appears at the top, showing your usage pace, remaining time, project folder, changes, and session details in real-time.

✅ Code sustainably

Now you always know if you're on track or need to slow down, helping you make the most of your AI sessions without surprises.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 12 to 12 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 claude-lens?

Claude-lens is a lightweight Bash and jq statusline for Claude Code CLI, displaying your model's effort level, project dir, git branch with diff stats, context usage bar, session duration, and crucially, remaining quotas for 5-hour and 7-day windows. Unlike basic usage meters, it tracks your *pace*—showing green if you're under-pacing (headroom ahead) or red if over, plus reset countdowns in hours or days. Install via quick curl download to ~/.claude/statusline.sh, chmod, and claude config set statusLine.command—works free with Claude Code API data or falls back to Anthropic usage endpoints.

Why is it gaining traction?

It stands out by predicting quota burnout before it hits, with color-coded bars (green >30% left, yellow 11-30%, red <=10%) and pace deltas like +17% headroom, helping devs push harder or throttle sustainably amid Claude Code pricing limits. Pairs seamlessly with Claude GitHub integration, Copilot workflows, or code review plugins, polling every 300ms without lag. At ~165 lines, it's a no-bloat claude code plugin that feels native, even on older Claude Code versions.

Who should use this?

Heavy Claude Code CLI users grinding long sessions, like backend devs chaining API calls or full-stack teams doing Claude GitHub code reviews and MCP integrations. Ideal for those eyeing claude code skills in GitHub Actions or apps, tired of surprise quota walls during claude code docs sprints or connector builds. Skip if you're on casual claude code free tier without rate pressure.

Verdict

Grab it if you're deep in Claude Code—solid docs and dead-simple claude code install make it worth the 30-second setup, despite 12 stars and 1.0% credibility signaling early maturity. Test on a side project first; no tests or broad adoption yet, but MIT license keeps it low-risk for quota-savvy workflows.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.