By chcardoz
Rich statusline showing model, context, session/weekly usage with progress bars
A Claude Code statusline plugin that displays model info, usage limits, Spotify, system metrics, GitHub contributions, and more — all in a compact box frame.
╭─ Claude Opus 4 ────────────────────────────────────────────────────── ⏱ 34m ─╮
│ ctx ████░░░░░░ 42% sess █░░░░░░░░░ 13% week ███░░░░░░░ 26% │
│ ↻ sess 6:00pm · week mar 5, 7:00pm │
│ ♫ ▶ Overcompensate - Twenty One Pilots · Focus Off · CPU 32% · MEM 71% │
│ │
│ M ▀▀▀▀▀▀▀▀ chcardoz/montreal +323 -51 │
│ W ▀▀▀▀▀▀▀▀ 262 contributions │
│ F ▀▀▀▀▀▀▀▀ 8w │
│ S ▀▀▀▀▀▀▀▀ │
╰──────────────────────────────────────────────────────────────────────────────╯
osascript, vm_stat, etc.)gh CLI (for GitHub contributions graph)claude --plugin-dir ./redline
Loads the plugin directly without installing. Good for iterating.
/plugin marketplace add ./redline
/plugin install redline@redline
Or use the interactive /plugin UI → Discover tab → select redline → choose scope.
/plugin marketplace add your-username/redline
/plugin install redline@your-username-redline
When installing, you pick a scope:
~/.claude/settings.json) — applies to all projects, all sessions. Best for a statusline..claude/settings.json) — applies to everyone on the repo..claude/settings.local.json) — just you, just this repo.| Section | Content |
|---|---|
| Progress bars | Context window, session (5h), and weekly (7d) usage with color-coded bars |
| Reset times | When session and weekly limits reset |
| Spotify | Currently playing track and play/pause state |
| Focus | macOS Focus/DND status |
| System | CPU and memory usage percentages |
| Contributions | 8-week GitHub contribution heatmap with git branch and diff stats |
| Stretch reminder | Session elapsed time with periodic stretch notifications |
Progress bars are color-coded:
Usage bars require an OAuth token. Without one, the statusline gracefully falls back to skeleton bars.
Edit config.json in the plugin directory:
{
"show": {
"model": true,
"context": true,
"session": true,
"weekly": true,
"reset_times": true,
"spotify": true,
"focus": true,
"system": true,
"stretch": true,
"contributions": true
},
"bar_size": 10,
"cache_ttl_seconds": 60,
"stretch_interval_minutes": 15,
"stretch_sound": "Glass",
"theme": {
"low_threshold": 50,
"high_threshold": 80
}
}
| Option | Description | Default |
|---|---|---|
show.* | Toggle individual sections on/off | all true |
bar_size | Number of characters in progress bars | 10 |
cache_ttl_seconds | How long to cache API usage responses | 60 |
stretch_interval_minutes | Minutes between stretch reminder notifications | 15 |
stretch_sound | macOS sound name for stretch notifications | "Glass" |
theme.low_threshold | Usage % below this is green | 50 |
theme.high_threshold | Usage % above this is red | 80 |
Expensive subprocess calls (Spotify, Focus, system metrics, git status) are cached with short TTLs (5–10s) and run in parallel using a thread pool. This brings typical render time down from ~500ms to under 100ms on cache hits.
Cache files are stored in ~/.cache/redline/. Delete the directory to force a fresh fetch.
The plugin looks for an OAuth token in this order:
~/.claude/.credentials.json → claudeAiOauth.accessTokenCLAUDE_CODE_OAUTH_TOKEN environment variable/plugin disable redline # Temporarily disable (keeps config)
/plugin enable redline # Re-enable
/plugin uninstall redline # Fully remove
Or use the interactive /plugin UI → Installed tab.
Run /redline inside Claude Code for a quick reference of what the plugin shows and how to configure it.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
npx claudepluginhub chcardoz/custom-claude-config --plugin redlineLive usage status bar for Claude Code — session limits, weekly usage, lines changed, 10 themes, widget priorities, shimmer animations, and zero API calls
Lightweight Claude Code status-line monitor with switchable styles, themes, and slash commands. v3.14.1 lowers the projection red line to 85% (yellow now 70–84) so a 7d window heading for →99% reads red instead of merely warm. v3.14.0 colours the 5h/7d bars by where usage is HEADED, not where it is now: once an end-of-window projection exists, the bar fill, label, and reset clock take their severity from the projected % against the cap (green <80, yellow 80–99, red ≥100) while the fill length still shows current usage — so a 7d window at 24% but on track for →96% reads yellow instead of a falsely-healthy green (all three styles). It also fixes the →NN% projection reading far too low for the first ~15 min after a reset (it was seeded from the used=0 first tick and lagged); it now holds `→--` until MIN_ELAPSED, then seeds from the first trustworthy reading. v3.13.3–v3.13.5 fix the 5h/7d bars sticking at a stale high % after Anthropic re-baselines usage mid-window (e.g. weekly limit raised): the cross-session merge now accepts an official downward revision once the old reading goes unconfirmed for 120s, idle windows replaying hours-old rate_limits blobs (expired 5h reset) can no longer overwrite or re-confirm the shared reading, and the →NN% projection drops its old-denominator samples and relearns after a re-baseline instead of freezing for the rest of the window. v3.13.0 adds a ⚙ session-mode line — effort (low/medium/high/xhigh/max/ultracode/auto) · thinking · fast · output-style — with a distinct static colour gradient per effort tier. v3.12.0 adds an always-on end-of-window projection (→NN%, learned from your local work rhythm) + an at-risk `⚠eta` forecast after each reset timer, session lines on by default, and a faint on-bar version that shows a `↑` hint when a newer release is on PyPI. v3.10.0 adds an opt-in live-activity line (in-progress todo, active tool, completed-tool rollup), git ahead/behind + session duration/lines on the project line, running-subagent lines, an opt-in `bar_shimmer` starfield on the battery bars, and a self-hosted plugin marketplace — plus a reliability fix so auto-update actually runs in daemon mode (detached, non-blocking) and the cache countdown is now per-session-correct. v3.9.0 makes the `cache` countdown auto-detect the real prompt-cache TTL (5m vs 1h) from the transcript, fixing a ~55-minute early `cache COLD` for Claude subscription users (Claude Code requests the 1-hour TTL automatically). v3.7.0 defends against status-line hijacking: a new `cs --setup --project [PATH]` writes a project-level override so another tool stealing the global `~/.claude/settings.json` slot can't kick `cs` out of this project; when displacement is detected, the bar also surfaces a one-line warning. v3.6.0 makes daemon (fast) mode the default for `cs --setup` — under 1% CPU continuously instead of ~3% inline at refreshInterval=1; pass `--inline` to opt back. Requires the `cs` CLI from PyPI (`pip install claude-statusbar` or `uv tool install claude-statusbar`).
A Claude Code statusline that shows reasoning effort (⚡) and thinking (💡). 5 presets (xsmall-xlarge), Catppuccin theme, no Node/Nerd Font, native PowerShell on Windows.
Modular statusline for Claude Code — peak hours, rate limits, rolling-window burn rate, cache reuse, plus a hook-injected narrator (rules + optional Haiku) that surfaces context-management advice above your prompt. Bilingual (English/Hebrew, locale auto-detect).
Comprehensive UI/UX design plugin for mobile (iOS, Android, React Native) and web applications with design systems, accessibility, and modern patterns
Standalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.