Owloops/claude-powerline

Claude Powerline – a status line for Claude Code

What it is

• A Node‑based plugin that adds a Vim‑style “powerline” status bar to Claude Code, the desktop UI for Anthropic’s Claude models.
• The bar lives at the bottom of the editor and shows live information about the current Claude session, Git repo, file system, and usage‑related metrics (tokens, cost, rate‑limit windows, etc.).

Why it matters

• Claude Code already reports a lot of telemetry (model name, context window, rate‑limit data). Powerline turns that data into a compact, constantly‑visible summary, helping developers keep an eye on token consumption, daily/monthly budgets, and Git state without opening separate panels.
• The tool is completely configurable – you can pick which segments appear, choose visual styles (classic powerline, capsule, minimal, or a full‑screen TUI), switch themes, and even define custom JSON configs.

Key features (as described in the README)

Feature	What you get
Real‑time usage tracking	Shows tokens used, estimated cost, daily/monthly totals, and a visual “budget” indicator.
Git integration	Branch name, SHA, ahead/behind arrows, stash count, and work‑tree markers.
Model & session info	Current Claude model, session ID, and optional extended‑thinking state.
Context window visualiser	Percent of the model’s context window used, with several bar styles (text, blocks, dots, etc.).
Rate‑limit windows	Displays Claude’s 5‑hour “block” and 7‑day “weekly” utilization, with optional pacing comparison.
Metrics	API response time, total session duration, message count, lines added/removed.
Tmux awareness	Shows the tmux session name when you run Claude Code inside tmux.
Theming & styles	Six built‑in themes (dark, light, nord, tokyo‑night, rose‑pine, gruvbox) and four visual styles; you can also create custom themes.
Zero runtime dependencies	The npm package ships as a single script; it pulls updates via npx automatically.
Configuration	JSON config files (project‑local, user‑level, XDG) that reload on change; CLI flags and environment variables override them.
Powerline Studio	A web UI (powerline.owloops.com) where you can drag‑and‑drop segments, preview styles, and export the resulting JSON config.

How to get it

1. Prerequisites – Node 18+, Claude Code, Git 2.0+, and a Nerd Font for the best Unicode symbols.
2. Installation – Either run the built‑in wizard inside Claude Code (/plugin marketplace add Owloops/claude-powerline … /powerline) or add a command entry to settings.json that invokes npx @owloops/claude-powerline.
3. Configuration – Run /powerline again to re‑open the wizard, or edit the generated ~/.claude/claude-powerline.json manually. You can also use the online Powerline Studio to craft a config and paste it back.

Typical use‑case A developer working with Claude Code wants to stay aware of how many tokens they are spending on a project. By enabling the Session and Today segments, the status line will show something like § 4.4M tokens $12.34 (79%) and update on each turn. At the same time, the Git segment keeps the current branch and ahead/behind status visible, so the developer never loses context while iterating between code and AI assistance.

Who might find it useful

• Anyone using Claude Code for code generation, debugging, or documentation who needs to monitor token usage and stay within budget.
• Teams that want a consistent visual cue across developers for Git status and AI‑assisted work.
• Power‑users who like highly‑customizable status lines (similar to Vim/Neovim powerline plugins) but within a GUI editor.

---

All details above are taken directly from the project's README; no additional features have been inferred.