magiccube/agentara/claude-usage

Usage — Claude Usage Monitor

Show the user their current Claude plan usage with ASCII progress bars.

Workflow

1. Fetch usage data

curl -s http://localhost:1984/api/usage/claude

Parse the JSON response. The shape is:

{
  "usage": {
    "five_hour": { "utilization": 9, "resets_at": "2026-03-15T12:00:00Z" },
    "seven_day": { "utilization": 40, "resets_at": "2026-03-20T14:00:00Z" },
    "extra_usage": { "is_enabled": false, ... }
  }
}

2. Build ASCII progress bar

For a given utilization percentage, render a 20-char wide bar:

• Filled char: █
• Empty char: ░
• Formula: filled = round(utilization / 5), empty = 20 - filled

Example for 40%: ████████░░░░░░░░░░░░ 40%

3. Format reset time

• For five_hour.resets_at: show relative time like "Resets in 3 hr 6 min"
• For seven_day.resets_at: show absolute time like "Resets Fri 2:00 PM"

4. Output

Present the result in this exact format:

Claude Usage
 
Session (5h rolling)
Resets in X hr Y min
████░░░░░░░░░░░░░░░░  20%
 
Weekly (7d rolling)
Resets Fri 2:00 PM
████████░░░░░░░░░░░░  40%
 
Extra usage: OFF

If extra usage is enabled, show Extra usage: ON instead.

5. Rules

• Keep output compact — no extra commentary unless the user asks.
• If utilization >= 80%, add a warning: ⚠ Running low!
• If utilization >= 95%, add: 🚨 Almost depleted!
• If the API call fails, tell the user the service is unreachable and suggest checking if the backend is running.