Claude Code status line
claude-usage-bar
A status bar that shows your Claude Code usage.
Install
git clone https://github.com/mnapoli/claude-usage-bar.gitFrom the README
Claude Usage Bar A menu bar app that displays your Claude usage in real-time. Features - Specifically designed for Claude Pro and Max usage tracking - Shows current session usage percentage in the menu bar - Displays weekly usage limits (all models and Sonnet-only) - Shows extra usage spending and remaining balance - Color-coded icon: green ( 95%) - Native notifications at 80% and 95% usage thresholds - Auto-refresh every 5 minutes (with manual refresh option) - Optional auto-start on login Unlike other usage trackers, this app loads the actual "Claude usage" web page under the hood to get accurate usage data. Installation Download the latest release for your platform from the Releases page. macOS 1. Download claude-usage-bar_x.x.x_aarch64.dmg (Apple Silicon) or claude-usage-bar_x.x.x_x64.dmg (Intel) 2. Open the .dmg and drag the app to Applications 3. On first launch, right-click the app and select "Open" to bypass Gatekeeper Windows 1. Download claude-usage-bar_x.x.x_x64-setup.exe 2. Run the installer Linux 1. Download claude-usage-bar_x.x.x_amd64.deb (Debian/Ubuntu) or claude-usage-bar_x.x.x_amd64.AppImage 2. Install the package or run the AppImage Building from source Prerequisites - Node.js (v18+) - Rust - Platform-specific dependencies: see Tauri prerequisites Build The built app will be in src-tauri/target/release/bundle/. How it works The app opens a hidden browser window to log into claude.ai and scrapes usage data from the settings page. Your credentials are handled by the browser and are never stored or transmitted by the app.
How status lines work
- A status line is a command Claude Code runs to draw the bar under the prompt. It gets the session as JSON on stdin (model, folder, cost, context) and prints one or more lines.
- Point the statusLine setting in ~/.claude/settings.json at it: { "statusLine": { "type": "command", "command": "<the command from the README>" } }.
- Or run /statusline inside Claude Code and describe what you want.
Details
- Repository
- mnapoli/claude-usage-bar
- Type
- Status lines
- Language
- Svelte
- License
- MIT
- Last updated
- 25 January 2026
FAQ
What is claude-usage-bar?
A status bar that shows your Claude Code usage. It is a status line for Claude Code, from mnapoli/claude-usage-bar on GitHub.
How do I install claude-usage-bar?
Clone mnapoli/claude-usage-bar from GitHub and follow the setup steps in its README.
Is claude-usage-bar popular?
mnapoli/claude-usage-bar has 115 GitHub stars and 8 forks. It was last updated on 25 January 2026.
More status lines
claude-code-statusline
120ilia-pluzhnikov/claude-code-statusline
A dependency-free Node.js status line with model, git state, context window, rate limits and a peak-hours indicator.
byebyecode
96byebye-code/byebyecode
An enhanced fork of CCometixLine that adds 88code account information to the status line.
starship-claude
151martinemde/starship-claude
Renders the Claude Code status line using your existing Starship prompt configuration.
claude-watch
70xleddyl/claude-watch
A minimal status line for Claude Code.
Quosparr
316Licoy/Quosparr
Native menu bar & tray app for macOS, Windows and Linux: track Codex, Claude Code and Grok quotas, resets, API-equivalent cost and local sessions, with multi-account and API relay switching | 原生 macOS、Windows、Linux 菜单栏与托盘应用,统一查看 Codex、Claude Code、Grok 额度、重置动态、API 等价成本与本机会话,支持多账号与中转 API 切换
arcade-statusline
81sorosora/arcade-statusline
An arcade-themed status line with a Pac-Man style chase game and a flower-trail animation.
Browse the most popular Claude Code mods, all status lines, or the skills and MCP server directories.