lumira
Real-time statusline plugin for Claude Code and Qwen Code.
Quick start
Via Claude Code plugin (recommended):
/plugin marketplace add cativo23/lumira
/lumira:setup
No npm required. The /lumira:setup skill writes statusLine.command automatically. Restart Claude Code when done.
Via npm:
npx lumira install
Interactive wizard — preset, theme, icons — previewed live before write.
What's new in v1.9.0: lumira is now a Claude Code plugin — install with /plugin marketplace add cativo23/lumira, no npm required. Run /lumira:setup to activate. v1.8.2 made the installer write a fast per-render command (~10× faster). v1.8.1 brought the GSD widget to parity with GSD 1.42.3. Earlier: compaction counter ⊙ N (v1.8.0), added-dirs badge + worktree breadcrumb (v1.7.0), lumira stats CLI (v1.5), API N% latency widget (v1.4.0), 7-day quota projection (v1.3.0).
Table of contents
Why lumira?
Claude Code's default statusline shows the model name and current directory. That's it. Lumira surfaces what actually changes during a session and what you'd want to react to:
- Context-window pressure — color-coded bar from green to blinking red, with a
/compact? hint at high fill so you act before hitting the wall.
- Burn rate —
$/h next to total cost, so a runaway agent shows up immediately.
- Rate-limit battery — 5h/7d usage shows as a Nerd Font battery glyph (or 🔋/🪫 in emoji mode) that fills as you consume quota, with a reset countdown above 70%. Hidden below 50% to keep the line uncluttered when you have margin.
- Active tools, agents, and todo progress — parsed from the live transcript, updated every render.
- Cross-platform — same config drives Claude Code and Qwen Code; Qwen sessions auto-collapse to single-line.
Inspired by GSD's statusline; takes its own stance on opt-in powerline rendering, theme contrast guarantees, and Qwen Code compatibility.
How lumira compares
The Claude Code statusline space has several good tools. Here's an honest head-to-head on features against the other true statuslines (feature claims checked against each tool's current README, 2026-06-14):
