Skip to main content

Lightweight status bar monitor for Claude AI token usage

Project description

Claude Status Bar

🔋 Lightweight status bar for Claude AI token usage in your terminal.

Claude Code Status Bar

✨ One-Line Install

curl -fsSL https://raw.githubusercontent.com/leeguooooo/claude-code-usage-bar/main/web-install.sh | bash

This automatically:

  • ✅ Installs the package
  • ✅ Configures Claude Code status bar
  • ✅ Sets up shell aliases
  • ✅ Just restart Claude Code and you're done!

💡 After installation: Restart Claude Code and say something to see your usage!

📦 Alternative Install Methods

# PyPI
pip install claude-statusbar

# uv (fast)
uv tool install claude-statusbar

# pipx (isolated)
pipx install claude-statusbar

🚀 Usage

claude-statusbar  # or cs for short

Output: 🔋 T:48.0k/133.3k | $:59.28/119 | ⏱️31m | Usage:50%

  • T: Token usage (current/limit)
  • $: Cost in USD
  • ⏱️: Time until reset
  • Usage %: Color-coded (🟢 <30% | 🟡 30-70% | 🔴 >70%)

🔧 Integrations

tmux status bar:

set -g status-right '#(claude-statusbar)'

zsh prompt:

RPROMPT='$(claude-statusbar)'

💖 Support

If you find this tool helpful, consider:

  • ⭐ Star this repo
  • 💖 Sponsor via GitHub
  • 🐛 Report issues

📄 License

MIT

⭐ Star History

Star History Chart


Built on Claude Monitor by @Maciek-roboblog

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

claude_statusbar-1.1.0.tar.gz (11.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

claude_statusbar-1.1.0-py3-none-any.whl (11.1 kB view details)

Uploaded Python 3

File details

Details for the file claude_statusbar-1.1.0.tar.gz.

File metadata

  • Download URL: claude_statusbar-1.1.0.tar.gz
  • Upload date:
  • Size: 11.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.5

File hashes

Hashes for claude_statusbar-1.1.0.tar.gz
Algorithm Hash digest
SHA256 82caf57f68287116d7e1e894c07551a72225e38929fc9f40eccca446dd4e4f97
MD5 20965e91c18d664cf2ab16aa4d72730b
BLAKE2b-256 068be2292e35ff3899a0e5ab7db7b7fbeeef4144b831111fd7f11568c9303691

See more details on using hashes here.

File details

Details for the file claude_statusbar-1.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for claude_statusbar-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 68ec02e771a7ab448968b0f3078e85dcfc3e5d66eb769fd780b5e62daa67e865
MD5 29bdeda5fff98db21dd49a5c78179fce
BLAKE2b-256 78902d9c18cbe0903bf10ff9b21166125e7e5934ee4bf73fbc0a7831135b490d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page