</>MCP Agents Market
Plugin

claude-powerline

by Owloops1.2kTypeScriptUpdated 2026-08-23

Beautiful vim-style powerline for Claude Code

Claude Code

claude-powerline is a Claude Code plugin that adds a customizable vim-style powerline statusline to the editor, displaying real-time usage metrics, git repository information, and session data. It offers multiple visual styles (minimal, powerline, capsule, TUI), six built-in themes plus custom theming, and tracks token consumption, costs, context windows, rate limits, and performance analytics. Developers install it via the Claude Code plugin marketplace or by configuring settings.json to run it as a status command, with an interactive setup wizard and visual web-based configurator available.

Key Features

Four visual styles: minimal, powerline with arrows, capsule with rounded caps, and bordered TUI panel mode with grid layout engine
Real-time usage tracking showing session, daily, and monthly token consumption and costs with configurable budget alerts
Git integration displaying branch, commit SHA, working tree status, ahead/behind indicators, stash count, and worktree detection
Context window monitoring with multiple display styles (text, bar, blocks, dots) and auto-compact threshold awareness
Rate limit tracking for 5-hour billing blocks and 7-day rolling windows with visual utilization bars
Performance metrics including API response times, session duration, message counts, and lines of code added/removed
Six built-in themes (dark, light, nord, tokyo-night, rose-pine, gruvbox) plus custom theme support with truecolor/256-color/ANSI compatibility
Interactive setup wizard and web-based Powerline Studio visual configurator for point-and-click customization

Use Cases

  • 01Monitor Claude API token usage and costs in real-time to stay within daily or monthly budgets
  • 02Track git repository status (branch, commits, working tree changes) directly in the Claude Code statusline
  • 03Visualize context window consumption to know when auto-compaction will trigger
  • 04Monitor 5-hour and 7-day rate limit utilization to avoid hitting Claude's usage caps
  • 05Customize the statusline appearance to match personal terminal themes and preferences
  • 06Track session performance metrics like response times and code modification statistics

Related Plugins

View more

claude-powerline — FAQ

What is claude-powerline?+

claude-powerline is a Claude Code plugin that adds a vim-style powerline statusline to the editor, displaying real-time usage tracking, git integration, context window monitoring, rate limits, and performance metrics with customizable themes and layouts.

How do I install claude-powerline in Claude Code?+

Use the interactive wizard by running '/plugin marketplace add Owloops/claude-powerline', then '/plugin install claude-powerline@claude-powerline', and finally '/powerline' to configure. Alternatively, add '"statusLine": {"type": "command", "command": "npx -y @owloops/claude-powerline@latest --style=powerline"}' to your Claude Code settings.json file.

Which Claude Code clients does this work with?+

This plugin works with Claude Code version 2.0+ (requires Node.js 18+ and Git 2.0+). It integrates directly into Claude Code's statusLine configuration and runs as a command-line tool invoked by the editor.

Do I need API keys or a Claude subscription to use it?+

No API keys are required to install and use the basic plugin. However, some features like 5-hour block and 7-day weekly rate limit tracking require Claude.ai Pro or Max subscription data that Claude Code provides natively.

Is claude-powerline free to use?+

Yes, claude-powerline is open-source software released under the MIT License with zero dependencies. The npm package is free to install and use.

Can I customize the statusline appearance and displayed segments?+

Yes, you can customize themes, visual styles, character sets (unicode/ASCII), segment visibility, display formats, budgets, and layouts through configuration files (~/.claude/claude-powerline.json) or the web-based Powerline Studio configurator at powerline.owloops.com.

How do I install claude-powerline?+

Open the source repository on GitHub and follow its README. claude-powerline is a plugin — MCP Agents Market links you directly to the official repo.

Is claude-powerline free?+

claude-powerline is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.

Related searches