{"repo":"shirley-xue-2025/usage-guard","free":true,"listed":false,"github":"https://github.com/shirley-xue-2025/usage-guard","clone":"git clone https://github.com/shirley-xue-2025/usage-guard.git","description":"Proactive 5h usage guard for Claude Code (macOS). Pause before extra wallet on long batch/subagent runs. Account-level window visibility. /usage-guard skill + daemon. Not affiliated with Anthropic.","language":"Python","stars":14,"topics":["agentic-ai","anthropic","automation","claude","claude-code","claude-desktop","claude-skills","fable","fable-5","fable5"],"license":"MIT","category":"workflow-automation","readme_excerpt":"usage-guard Opt-in proactive usage guard for long Claude Code sessions (macOS — Desktop Code tab and CLI). Monitors the account 5-hour window (default pause at 90%) and, optionally, the weekly limit (default pause at 98%) — either can trigger a checkpoint before you hit the wall. Arm with /usage-guard before long batch, subagent, or overnight work — especially when the shared window is already partly used. An external daemon reads your usage (zero session tokens), sets PAUSE before limits, sends macOS notifications, and you resume with /usage-guard resume after reset — without chat reminders that get queued behind subagents. Latest: v0.2.2 — fail-closed when blind ( UNKNOWN ), valid until freshness, LaunchAgent KeepAlive, blind-alert backoff. See CHANGELOG / release notes. Who is this for? - Long Claude Code sessions that burn the 5-hour window quickly (batch jobs, subagents, /loop , multi-session arcs) - Work that starts when usage is already high — arm gives account-level visibility, not just this chat's view - Weekly limit nearly full while the current session still looks safe (e.g. 60% session, 97% weekly) — enable weekly monitoring in config - Subagent / batch work where mid-session chat messages stay queued - You want to pause near 90% (5h) or 98% (weekly) and avoid extra usage wallet charges at 100% - macOS — Claude Desktop Code tab or Claude Code CLI - You can arm once per session ( /usage-guard ) — no per-project setup Also used on heavy model runs (e.g. Fable when a","default_branch":null,"files":null,"tree":[],"storefront":"/r/shirley-xue-2025","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/shirley-xue-2025/usage-guard/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}