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 | 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)
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:
