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
- Inside Claude Code, add the plugin marketplace and install:
/plugin marketplace add fredrikaverpil/claudeline
/plugin install claudeline@claudeline
- Run
/claudeline:setup inside Claude Code — this downloads the Go binary and
configures your statusline
- Restart Claude Code
Manual
- Download the latest binary from
GitHub releases, or
use
go install github.com/fredrikaverpil/claudeline@latest.
- 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
- 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:
