claudeline

claudeline

A minimalistic and opinionated Claude Code status line.

It displays the subscription plan (or API/provider), current Anthropic model, context window usage, and 5-hour/7-day quota usage as ANSI-colored progress bars. Written in Go with no external dependencies (stdlib only).

[!NOTE]

The 5-hour and 7-day quota bars require a Claude Code subscription (Pro, Max, or Team). They are not available for Enterprise or API key users. The bars may also disappear silently if the usage API is temporarily unavailable or rate limited — use -debug to diagnose.

Indicator legend

Indicator	Meaning
⚡️	Peak hours: 5-hour limit burns faster than normal. Disabled since SpaceX deal.
⚠️	Approaching auto-compaction threshold
🥵	Extended context (>200k tokens) — model quality may degrade
🔥▂ 🔥▄▂ 🔥▆▄▂	Anthropic service disruption (minor / major / critical)
🥊	Prompt cache miss — this turn was not served from cache (costs more)
↑	New claudeline update available

Installation

Via Claude Code plugin

1. Inside Claude Code, add the plugin marketplace and install:

/plugin marketplace add fredrikaverpil/claudeline
/plugin install claudeline@claudeline

2. Run /claudeline:setup inside Claude Code — this downloads the Go binary and configures your statusline
3. Restart Claude Code

Manual

1. Download the latest binary from GitHub releases, or use go install github.com/fredrikaverpil/claudeline@latest.
2. Add the statusline to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "/path/to/claudeline",
  },
}

[!TIP]

If installing via go install, set the command to ~/go/bin/claudeline

3. Restart Claude Code

Flags

Flag	Default	Description
-debug	false	Write warnings/errors to /tmp/claudeline/debug.log
-cwd	false	Show working directory name in the status line
-cwd-max-len	30	Max display length for working directory name
-git-branch	false	Show git branch in the status line
-git-branch-max-len	30	Max display length for git branch
-cost	false	Show estimated session cost in the status line
-usage-file		Read usage data from file instead of API
-status-file		Read status data from file instead of API
-update-file		Read update data from file instead of API
-version	false	Print version and exit

Example with working directory and git branch enabled:

{
  "statusLine": {
    "type": "command",
    "command": "claudeline -cwd -git-branch"
  }
}

Architecture

Single-binary design with main.go orchestrating internal/ packages.

Data flow: stdin JSON → parse input + read credentials → fetch usage (cached) + fetch status (cached) + check update (cached) → render ANSI output → stdout

Key components: