claude-powerline

Claude Powerline

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

[](https://www.npmjs.com/package/@owloops/claude-powerline) [](https://www.npmjs.com/package/@owloops/claude-powerline) [](https://packagephobia.com/result?p=@owloops/claude-powerline) [](https://www.npmjs.com/package/@owloops/claude-powerline)

[](https://github.com/hesreallyhim/awesome-claude-code)

Demo

_Live demonstration: real-time usage tracking, git integration, and theme showcase_

     Dark

     

     Light

     

     Nord

     

     Tokyo Night

     

     Rose Pine

     

     Create your own!

Features

**Real-time usage tracking**

Monitor session costs, 5-hour billing windows, and daily budgets with percentage alerts.

**Git integration**

Branch status, commits ahead/behind, working tree changes, and repository info at a glance.

**6 built-in themes**

Dark, light, nord, tokyo-night, rose-pine, and gruvbox themes with full custom color support.

**Multiple styles**

Minimal, powerline, capsule, and TUI panel display with unicode or ASCII character sets.

**Auto-wrap layout**

Segments automatically wrap to new lines based on terminal width. No more cutoff.

**Zero dependencies**

Lightweight and fast with no external dependencies to install.

Installation

Setup

Requires Node.js 18+, Claude Code, and Git 2.0+. For best display, install a [Nerd Font](https://www.nerdfonts.com/) or use `--charset=text` for ASCII-only symbols.

**1. Add to your Claude Code `settings.json`:**

{
  "statusLine": {
    "type": "command",
    "command": "npx -y @owloops/claude-powerline@latest --style=powerline"
  }
}

**2. Start a Claude session** - the statusline appears at the bottom during conversations.

...