Claude Code status line

claude-powerline

A vim-style powerline status line with usage tracking, git integration and custom themes.

1,174 stars 85 forksStatus lines Plugin marketplace Source

Install

Add the plugin marketplace

/plugin marketplace add Owloops/claude-powerline

Run inside Claude Code, then /plugin to pick what to install from it.

Install

npx -y @owloops/claude-powerline

From source

git clone https://github.com/Owloops/claude-powerline.git

From the README

Claude Powerline

A vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, and custom themes.

Installation

Requires Node.js 18+, Claude Code, and Git 2.0+. For best display, install a Nerd Font or use --charset=text for ASCII-only symbols.

Setup Wizard (Recommended)

The interactive wizard walks you through theme, style, font, segment, and budget selection.

The wizard writes ~/.claude/claude-powerline.json and updates your settings.json automatically. Run /powerline again any time to reconfigure.

Manual Setup

Add to your Claude Code settings.json:

Start a Claude session and the statusline appears at the bottom. Using npx automatically downloads and runs the latest version without manual updates.

Powerline Studio

powerline.owloops.com is a visual configurator for claude-powerline. Click segments in the preview to toggle options, switch styles and themes live, reorder, then copy or download the JSON into ~/.claude/claude-powerline.json. Paste an existing config to edit it.

Styles

Themes

6 built-in themes (dark, light, nord, tokyo-night, rose-pine, gruvbox) or create your own.

Configuration

Config locations (in priority order):

- ./.claude-powerline.json - Project-specific
- ~/.claude/claude-powerline.json - User config
- ~/.config/claude-powerline/config.json - XDG standard

Override priority: CLI flags > Environment variables > Config files > Defaults

Config files reload automatically, no restart needed.

Get example config:

CLI Options and Environment Variables

CLI Options (both --arg value and --arg=value syntax supported):

- --theme - dark (default), light, nord, tokyo-night, rose-pine, gruvbox, custom
- --style - minimal (default), powerline, capsule, tui
- --charset - unicode (default), text
- --config -…

Read the full README on GitHub

How status lines work

A status line is a command Claude Code runs to draw the bar under the prompt. It gets the session as JSON on stdin (model, folder, cost, context) and prints one or more lines.
Point the statusLine setting in ~/.claude/settings.json at it: { "statusLine": { "type": "command", "command": "<the command from the README>" } }.
Or run /statusline inside Claude Code and describe what you want.

Claude Code docs

Details

Repository: Owloops/claude-powerline
Type: Status lines
Website: powerline.owloops.com
Language: TypeScript
License: MIT
Last updated: 2 November 2026
Topics: claude-codeclideveloper-toolsgitlightweightstatusline
Listed in: awesome-claude-code, awesome-claude-code (extra), jqueryscript/awesome-claude-code

FAQ

What is claude-powerline?

A vim-style powerline status line with usage tracking, git integration and custom themes. It is a status line for Claude Code, from Owloops/claude-powerline on GitHub.