claudeline plugin
claudeline draws a Claude Code status line: plan, model, context usage and 5-hour and 7-day limits.
- 55 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The program reads Claude Code credentials to query limit usage, and `/claudeline:setup` downloads and runs a binary.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/claudelineDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The program reads Claude Code credentials to query limit usage, and `/claudeline:setup` downloads and runs a binary.
This is third-party code. Review the repository files before installing.
What it does
claudeline is a minimalistic status line for Claude Code written in Go with no external dependencies. It shows the plan or provider, the current Anthropic model, context window usage and consumption of the 5-hour and 7-day limits as colored bars. Icons flag peak hours, nearing auto-compaction and extended context beyond 200 thousand tokens. It installs as a plugin: after `/plugin install claudeline@claudeline` the `/claudeline:setup` command downloads the binary and writes the status line setting. The flags `-cwd`, `-git-branch`, `-cost` and `-effort` add the working directory, Git branch, estimated session cost and model effort level.
Who it is for. Claude Code subscribers who want limit consumption and context usage visible in the terminal rather than on separate pages.
Good fit when
- You want to see early that the 5-hour limit is running out.
- Context is nearly full and must be compacted in time rather than losing details.
- A status line is needed without Node.js and heavy dependencies.
- The Git branch and working directory should appear next to the model.
Not a fit when
- You work with an API key or an Enterprise plan: the limit bars are unavailable to them.
- The program must not be allowed to contact the usage statistics service.
- The built-in status line is enough and suits you.
Example request
Install claudeline, turn on the Git branch and working directory in the status line and explain the icons.Limitations
The 5-hour and 7-day limit bars require a Claude Code Pro, Max or Team subscription and do not work for Enterprise and API key users. If the usage service is unavailable or rate limited the bars vanish silently; the `-debug` flag writes a log to `/tmp/claudeline/debug.log` to diagnose. To detect the plan the program reads Claude Code credentials following the client's own authentication rules. The binary is downloaded by `/claudeline:setup` or installed through `go install`.
How to disable. Remove the plugin with `/plugin uninstall claudeline@claudeline` and delete the `statusLine` entry from `~/.claude/settings.json`. The binary is deleted by hand.
FAQ
What does the line show?
The plan or provider, the Anthropic model, context usage and 5-hour and 7-day limit bars, plus status icons.
Why did the limit bars disappear?
They need a Pro, Max or Team subscription. They also vanish when the usage service is unavailable: run with `-debug` and read the log.
How do I install without the plugin?
Download the binary from releases or run `go install github.com/fredrikaverpil/claudeline@latest`, then add `statusLine` to `~/.claude/settings.json`.
Which options exist?
`-cwd`, `-git-branch`, `-cost`, `-effort` and length limits such as `-cwd-max-len`. The full flag table is in the README.
Are external libraries needed?
No, the program is written in Go using only the standard library.
Discussion
No questions or reviews yet.
Related
PluginsA Claude Code status line showing model, effort level, context fill, git branch and the 5-hour and weekly limits.
A statusline for Claude Code: token and cost usage, context left, rate limits and git branch in four styles and six themes
A Claude Code status line showing 5-hour and 7-day quota use plus the pace: whether what is left lasts until the window resets
A Claude Code plugin: a status line with context, 5-hour and 7-day limits, cost and usage of Codex, Gemini and z.ai
A Claude Code status line with 5-hour and weekly limit usage, reset countdowns, model and prompt cache lifetime
A customizable status line for Claude Code: model, git branch, context, usage limits and other widgets
README in short
Describes the status line, the icon legend, plugin and manual installation, flags, internals and provider detection order.