← Back to Skills Marketplace
mfang0126

How Much Claude Left?

by mfang0126 · GitHub ↗ · v1.1.1
cross-platform ✓ Security Clean
318
Downloads
0
Stars
2
Active Installs
3
Versions
Install in OpenClaw
/install claude-quota-checker
Description
Check how much Claude Max / Claude Pro subscription quota you have LEFT — not how much you spent. Most usage tools track API billing or token costs. This one...
README (SKILL.md)

Claude Quota Checker

How much Claude do you have LEFT?

Most tools tell you how much you spent. This one tells you how much you have remaining — the question that actually matters when you're working and worried about hitting limits.

Checks your Claude Max/Pro subscription quota by automating the /usage command via tmux. No API keys needed, no Admin keys, no complex setup.

How It Works

  1. Creates a temporary tmux session with a scratch git repo
  2. Launches Claude Code CLI
  3. Handles the "trust this folder" prompt automatically
  4. Sends /usage command
  5. Captures and parses the output
  6. Cleans up tmux session

Usage

bash ./scripts/check-usage.sh

Note: Run from the skill directory, or use the full path based on where you installed this skill. The script auto-detects its own location.

Output

  • Plan type: Pro or Max (e.g., "Opus 4.6 — Claude Max")
  • Session usage: current session % used
  • Weekly usage: all models % and Sonnet-only %
  • Reset time: when the weekly quota resets

Error Handling

Problem Symptom Fix
tmux not installed command not found: tmux brew install tmux
Claude CLI not in PATH Session hangs Install Claude Code CLI, ensure claude is in PATH
Auth expired "Please log in" in output Run claude manually and re-authenticate
Git not installed Script fails at git init brew install git

If the script hangs for >15 seconds, it likely means Claude CLI couldn't start. Kill with: tmux kill-session -t cu-*

Requirements

  • macOS or Linux
  • tmux installed
  • claude CLI in PATH
  • Active Claude Code authentication (Pro or Max subscription)
  • git installed (for scratch repo)

Performance

~8-10 seconds (bottleneck: Claude Code CLI startup time).

Limitations

  • Only checks subscription usage (Pro/Max), not API billing
  • Requires a running terminal environment (won't work in sandboxed containers)
  • Output parsing depends on Claude Code CLI's /usage format — may break if Anthropic changes the output layout
Usage Guidance
This script appears to do exactly what it says: run your local 'claude' CLI in a temporary tmux session and parse the /usage output. Before running, verify you trust the 'claude' binary you have installed (it will use whatever local auth tokens exist and may perform network calls). You can review the short script (it's included) — it creates a temp directory, runs claude, captures output, and deletes the temp files. If you're cautious, run 'claude' manually to confirm behavior and authentication, or run the script in an isolated environment (VM/container) first. It will not send your system files or credentials anywhere on its own.
Capability Analysis
Type: OpenClaw Skill Name: claude-quota-checker Version: 1.1.1 The skill is a utility designed to check Claude Pro/Max subscription quotas by automating the 'claude' CLI via tmux. The bash script (scripts/check-usage.sh) uses standard system tools (tmux, git, mktemp) to capture and parse usage statistics locally without any evidence of data exfiltration, persistence, or malicious execution.
Capability Assessment
✓ Purpose & Capability
Name and description say it will check Claude subscription quota. The script only requires tmux, git, and the 'claude' CLI and uses them to run '/usage' in a temporary tmux session — exactly what you'd expect for this task.
ℹ Instruction Scope
SKILL.md directs running the included shell script. The script launches the local 'claude' CLI, handles the trust prompt, sends '/usage', captures output, and cleans up. This stays within the stated scope. Note: invoking the local 'claude' binary will cause that binary to perform network activity and use any auth it has — that's expected for querying subscription status but is an external dependency to trust.
✓ Install Mechanism
No install spec; instruction-only plus a small shell script. Nothing is downloaded or extracted from remote URLs, and no third-party packages are installed by the skill itself.
✓ Credentials
The skill declares no environment variables or credentials. The script does not read unrelated files or env vars. It relies on the existing local 'claude' authentication (as it must) but does not attempt to exfiltrate tokens or access other services.
✓ Persistence & Privilege
always is false and the skill does not persist changes to agent config or other skills. It creates only a temporary directory and tmux session and cleans them up on exit.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install claude-quota-checker
  3. After installation, invoke the skill by name or use /claude-quota-checker
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.1
v1.1.1: Renamed for discoverability — the name is the question everyone's asking.
v1.1.0
v1.1.0: Rewritten description to highlight key differentiator — shows remaining quota %, not spending. Pre-flight diagnostics, error handling, auto trust-prompt.
v1.0.0
Initial release: check Claude Max/Pro subscription usage via tmux + Claude CLI. Auto-handles trust prompt, auth detection, pre-flight checks.
Metadata
Slug claude-quota-checker
Version 1.1.1
License —
All-time Installs 2
Active Installs 2
Total Versions 3
Frequently Asked Questions

What is How Much Claude Left??

Check how much Claude Max / Claude Pro subscription quota you have LEFT — not how much you spent. Most usage tools track API billing or token costs. This one... It is an AI Agent Skill for Claude Code / OpenClaw, with 318 downloads so far.

How do I install How Much Claude Left??

Run "/install claude-quota-checker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is How Much Claude Left? free?

Yes, How Much Claude Left? is completely free (open-source). You can download, install and use it at no cost.

Which platforms does How Much Claude Left? support?

How Much Claude Left? is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created How Much Claude Left??

It is built and maintained by mfang0126 (@mfang0126); the current version is v1.1.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463942 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259883 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200739 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191401 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190375 · by oswalpalash

💬 Comments