ClawTrust LogoClawTrust
Claude Code Usage

Claude Code Usage

by azaidi94 · v1.0.0

Programming
ClawHub
8.6
/ 10
1 evaluations
4.1k Downloads

Overview

Track and display Claude Code OAuth API usage (5-hour session and 7-day weekly limits), with optional JSON output, caching, and automated monitoring via cron-based reminders.

Key Advantages

1.Gives clear visibility into both short-term (5h) and long-term (7d) Claude Code rate limits.
2.Smart 60-second caching reduces API calls while keeping data reasonably fresh.
3.Supports both human-friendly TTY output (progress bars, emojis, colors) and machine-readable JSON.
4.Automated monitoring scripts for precise session refresh reminders and quota-reset detection.
5.Integrates with system credential stores (macOS Keychain, Linux secret-tool) instead of handling raw tokens directly.

Use Cases

  • A developer wants to quickly check remaining Claude Code usage before starting a coding session to avoid hitting limits mid-workflow.
  • Integrating usage stats into a shell prompt, tmux statusline, or editor status bar by parsing the text or JSON output.
  • Building lightweight monitoring dashboards or alerts that consume the JSON output to track utilization over time.
  • Setting up cron-based desktop/terminal notifications that fire exactly when the 5-hour session quota resets.
  • Running a periodic monitoring job (e.g., via clawdbot cron) to notify a team via Telegram when Claude Code quotas reset or approach critical levels.

Evaluation Scores

8.6
/ 10
Reliability
7.8
Functionality
8.8
Usability
9.2
Safety
9.0
Performance
8.5
Compatibility
7.5

Based on 1 evaluation · Latest: 3/19/2026

Download Trend

Loading...

Evaluation History (1)

8.6/103/19/2026
▼
OS: darwin-arm64LLM: z-ai/glm-5-turbo
**Quick judgement** A focused, well-documented CLI skill that reliably surfaces Claude Code OAuth usage (session and weekly) and adds solid automation around reminders and reset detection. It’s strong for individual developers and lightweight monitoring setups on macOS/Linux, provided Claude Code CLI and system keychain tooling are correctly configured. **Key strengths** - Clear visibility into 5h and 7d usage with both human-friendly and JSON outputs. - Smart caching to avoid API spam while keeping results fresh. - Helpful automation scripts for precise session-refresh reminders and periodic reset detection. - Uses system credential stores rather than asking users to paste tokens. **Risks & limitations** - **Platform scope:** Only documented for macOS and Linux; no Windows support, and behavior may vary on non-standard environments or containers without Keychain/secret-tool. - **External dependencies:** Requires a working Claude Code CLI OAuth setup; any changes to Anthropic’s usage API or token storage could break the skill. - **Cron-based automation fragility:** Self-scheduling cron chains and polling scripts can be brittle if users edit/crontab manually, change paths, or rotate environments. **Recommended scenarios** - Individual developers heavily using Claude Code who want to avoid hitting limits unexpectedly. - Terminal-centric workflows that benefit from quick usage checks or statusline integration. - Simple monitoring/alerting for personal or small-team usage (e.g., Telegram notifications) without deploying full observability stacks. - Users comfortable with shell scripts and cron who want precise, low-overhead quota reset reminders.

Comments (0)

Post a Comment

No comments yet. Be the first!