@owloops/claude-powerline weekly downloads statistics

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 - Custom config file path • --help - Show help

Examples:

Environment Variables:

Segment Configuration

Directory - Shows current working directory name

Options:

• style: Display format - full | fish | basename • full: Show complete path (e.g., ~/projects/claude-powerline) • fish: Fish-shell style abbreviation (e.g., ~/p/claude-powerline) • basename: Show only folder name (e.g., claude-powerline)

In --worktree sessions, the directory segment automatically shows the original repo path instead of the worktree folder (no config required).

Git - Shows branch, status, and repository information

Options:

• showSha: Show abbreviated commit SHA • showWorkingTree: Show staged/unstaged/untracked counts • showOperation: Show ongoing operations (MERGE/REBASE/CHERRY-PICK) • showTag: Show nearest tag • showTimeSinceCommit: Show time since last commit • showStashCount: Show stash count • showAheadBehind: Show ahead/behind arrows (default true) • showUpstream: Show the upstream branch name, e.g. →origin/main • showRepoName: Show repository name • showWorktree: Show the worktree indicator (⧉) when the current directory belongs to a linked git worktree. Defaults to whatever showRepoName is, so set it explicitly to get the indicator on its own — or to false to suppress it while still showing the repo name

The two upstream options are independent. showUpstream controls the branch name only, showAheadBehind controls the ↑/↓ arrows. The default (showUpstream: false) already gives you arrows without the name; to drop the arrows too, set showAheadBehind: false.

Symbols:

• Unicode: ⎇ Branch • ♯ SHA • ⌂ Tag • ⧇ Stash • ✓ Clean • ● Dirty • ⚠ Conflicts • ↑3 Ahead • ↓2 Behind • ⧉ Worktree • (+1 ~2 ?3) Staged/Unstaged/Untracked • Text: ~ Branch • # SHA • T Tag • S Stash • = Clean • * Dirty • ! Conflicts • ^3 Ahead • v2 Behind • W Worktree • (+1 ~2 ?3) Staged/Unstaged/Untracked

Model - Shows current Claude model being used

Symbols: ✱ Model (unicode) • M Model (text)

Session - Shows real-time usage for current Claude conversation

Options:

• type: Display format - cost | tokens | both | breakdown • costSource: Cost calculation method - calculated (ccusage-style) | official (hook data) • showUnits: Show the trailing tokens unit when type is tokens or both (default: true). Set to false to render § 4.4M instead of § 4.4M tokens. Only applies to the powerline/capsule/minimal styles; the tui style already renders tokens without a suffix

Symbols: § Session (unicode) • S Session (text)

Today - Shows total daily usage with budget monitoring

Options:

• type: Display format - cost | tokens | both | breakdown • showUnits: Show the trailing tokens unit when type is tokens or both (default: true). Set to false to render ☉ $12.34 (4.4M) instead of ☉ $12.34 (4.4M tokens). Only applies to the powerline/capsule/minimal styles; the tui style already renders tokens without a suffix

Symbols: ☉ Today (unicode) • D Today (text)

Month - Shows total usage for the current calendar month with budget monitoring

Options:

• type: Display format - cost | tokens | both | breakdown • showUnits: Show the trailing tokens unit when type is tokens or both (default: true). Set to false to render ◫ $123.45 (4.4M) instead of ◫ $123.45 (4.4M tokens). Only applies to the powerline/capsule/minimal styles; the tui style already renders tokens without a suffix

Opt-in (enabled: false by default). Resets on the 1st of each month.

budget.month.amount defaults to 500 (like today's default of 50) unless overridden. Set it to 0 to disable the percentage — omitting the month key entirely does not disable it, since the default still applies (see Budget Configuration below).

Symbols: ◫ Month (unicode) • Mo Month (text)

Context - Shows context window usage and auto-compact threshold

Options:…

Description from the npm listing.