Open Source

monclaude

A rich, real-time status line for Claude Code

Monitor your context window, rate limits, peak hours, and costs — all without leaving your terminal.

GitHub
terminal
Opus 4.6 (1M context) | ●○○○○○○○○○ 51k/1.0m (5%) | ~$0.99
5hr ●○○○○○○○○○ 13% in 1h 33m | 7d ●○○○○○○○○○ 11% in 4d 10h | extra $33.05/$50

What you get

Context window

Color-coded progress bar showing token usage against your model's context limit, with human-readable formatting.

Rate limits

5-hour rolling and 7-day usage with countdown timers until reset. Know exactly where you stand.

Peak hours

Detects weekday 5–11am PT windows when session limits burn faster. Yellow PEAK badge warns you.

Cost tracking

Running session cost and extra credit usage with monthly cap visibility. No surprises.

Install

One-liner

$ curl -fsSL https://raw.githubusercontent.com/amirhjalali/monclaude/main/install.sh | bash

Requirements

  • Claude Code CLI
  • jq (brew install jq)
  • macOS (uses Keychain & BSD utilities)
  • Claude Pro, Max, or Team subscription

How it works

1

Claude Code pipes session JSON (model, context, cost) into the script via stdin

2

The script calls the Anthropic usage API for 5-hour and 7-day rate limit data

3

API responses are cached for 60 seconds to keep things snappy

4

Peak hours are detected locally by checking current time against weekday 5–11am PT