code
Open Source

monclaude

A rich, real-time status line for Claude Code

See context usage, rate limits, reset timers, and session cost without leaving your terminal.

terminal
Opus 4.8 (1M context)xhigh[22%]220k/1.0m|~$1.24
5h[34%]in 2h 6m|7d[31%]in 1d 4h·69% left before reset

What you get

Context window

A compact bar with the percentage riding inside it, plus tokens used against your model's full context limit.

Rate limits

5-hour and 7-day rolling usage with reset countdowns, plus a nudge when the weekly window resets soon and you still have room.

Reasoning effort

The active thinking level rides next to the model name when set: low, med, high, xhigh, or max.

Cost tracking

Running session cost so you can see when a session is getting expensive, with extra-credit cap visibility when enabled.

Install

Homebrew

$ brew tap amirhjalali/monclaude https://github.com/amirhjalali/monclaude
$ brew install monclaude

One-liner

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

Requirements

  • Claude Code CLI
  • jq (brew install jq)
  • macOS or Linux
  • 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

Responses are cached for 180 seconds, with a mutex serializing refreshes across concurrent sessions

4

Narrow terminals automatically switch to a compact one-line mode