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.
# run inside Claude Code, one at a time
/plugin marketplace add Owloops/claude-powerline
/plugin install claude-powerline@claude-powerline
/powerline
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:
{
"statusLine": {
"type": "command",
"command": "npx -y @owloops/claude-powerline@latest --style=powerline"
}
}
Start a Claude session and the statusline appears at the bottom. Using npx automatically downloads and runs the latest version without manual updates.
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:
curl -o ~/.claude/claude-powerline.json https://raw.githubusercontent.com/Owloops/claude-powerline/main/.claude-powerline.json
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:
claude-powerline --theme=nord --style=powerline
claude-powerline --theme=dark --style=capsule --charset=text
claude-powerline --config=/path/to/config.json
Environment Variables:
export CLAUDE_POWERLINE_THEME=dark
export CLAUDE_POWERLINE_STYLE=powerline
export CLAUDE_POWERLINE_CONFIG=/path/to/config.json
export CLAUDE_POWERLINE_DEBUG=1 # Enable debug logging
Segment Configuration
Directory - Shows current working directory name
"directory": {
"enabled": true,
"style": "full"
}
Options:
style: Display format -full|fish|basenamefull: 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)
Git - Shows branch, status, and repository information
"git": {
"enabled": true,
"showSha": true,
"showWorkingTree": false,
"showOperation": false,
"showTag": false,
"showTimeSinceCommit": false,
"showStashCount": false,
"showUpstream": false,
"showRepoName": false
}
Options:
showSha: Show abbreviated commit SHAshowWorkingTree: Show staged/unstaged/untracked countsshowOperation: Show ongoing operations (MERGE/REBASE/CHERRY-PICK)showTag: Show nearest tagshowTimeSinceCommit: Show time since last commitshowStashCount: Show stash countshowUpstream: Show upstream branchshowRepoName: Show repository name
Symbols: