Claude Code status line

claude-usage-bar

A status bar that shows your Claude Code usage.

115 stars 8 forksStatus lines Source

Install

From source
git clone https://github.com/mnapoli/claude-usage-bar.git

From 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.
Read the full README on GitHub

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.
Claude Code docs

Details

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

Browse the most popular Claude Code mods, all status lines, or the skills and MCP server directories.