# Claude Status Bar
🔋 Lightweight status bar for Claude AI token usage in your terminal.
## ✨ One-Line Install
```bash
curl -fsSL "https://raw.githubusercontent.com/leeguooooo/claude-code-usage-bar/main/web-install.sh?v=$(date +%s)" | bash
```
> 💡 The `?v=$(date +%s)` parameter ensures you get the latest version without CDN caching issues.
**If you still see old version, try with additional cache-busting:**
```bash
curl -fsSL -H "Cache-Control: no-cache" "https://raw.githubusercontent.com/leeguooooo/claude-code-usage-bar/main/web-install.sh?v=$(date +%s)&r=$RANDOM" | 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
```bash
# PyPI
pip install claude-statusbar
# uv (fast)
uv tool install claude-statusbar
# pipx (isolated)
pipx install claude-statusbar
```
## 🚀 Usage
```bash
claude-statusbar # or cs for short
```
Output: `🔋 T:48.0k/133.3k | $:59.28/90.26 | 🤖opusplan | ⏱️31m | Usage:16.5%`
- **T**: Token usage (current/limit)
- **$**: Cost in USD (dynamic P90 limits)
- **🤖**: Current Claude model
- **⏱️**: Time until reset
- **Usage %**: Cost-based percentage, color-coded (🟢 <30% | 🟡 30-70% | 🔴 >70%)
## 🔧 Integrations
**tmux status bar:**
```bash
set -g status-right '#(claude-statusbar)'
```
**zsh prompt:**
```bash
RPROMPT='$(claude-statusbar)'
```
## 🔄 Upgrading
### Automatic Updates (Recommended)
The tool automatically checks for updates once per day and upgrades itself. No action needed! 🎉
When an update is available, you'll see: `🔄 Upgraded from v1.0.0 to v1.1.0`
### Manual Upgrade
If automatic upgrade fails, you can manually update:
```bash
# Re-run the installer (recommended - always gets latest)
curl -fsSL "https://raw.githubusercontent.com/leeguooooo/claude-code-usage-bar/main/web-install.sh?v=$(date +%s)" | bash
# Or upgrade via package manager:
# If installed with pip
pip install --upgrade claude-statusbar
# If installed with pipx
pipx upgrade claude-statusbar
# If installed with uv
uv tool upgrade claude-statusbar
```
**Note:** After upgrading, restart Claude Code to use the new version.
## 💖 Support
If you find this tool helpful, consider:
- ⭐ Star this repo
- 💖 Sponsor via GitHub
- 🐛 Report issues
## 📄 License
MIT
## ⭐ Star History
[](https://star-history.com/#leeguooooo/claude-code-usage-bar&Date)
---
*Built on [Claude Monitor](https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor) by [@Maciek-roboblog](https://github.com/Maciek-roboblog)*
Raw data
{
"_id": null,
"home_page": null,
"name": "claude-statusbar",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "claude, ai, monitoring, statusbar, token-usage",
"author": null,
"author_email": "leeguooooo <leeguooooo@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/c9/43/f36cf4cabf08e94c3a41de06030047e1b4b4db9649cda71ac8935e0fe11d/claude_statusbar-1.2.2.tar.gz",
"platform": null,
"description": "# Claude Status Bar\n\n\ud83d\udd0b Lightweight status bar for Claude AI token usage in your terminal.\n\n\n\n## \u2728 One-Line Install\n\n```bash\ncurl -fsSL \"https://raw.githubusercontent.com/leeguooooo/claude-code-usage-bar/main/web-install.sh?v=$(date +%s)\" | bash\n```\n\n> \ud83d\udca1 The `?v=$(date +%s)` parameter ensures you get the latest version without CDN caching issues.\n\n**If you still see old version, try with additional cache-busting:**\n```bash\ncurl -fsSL -H \"Cache-Control: no-cache\" \"https://raw.githubusercontent.com/leeguooooo/claude-code-usage-bar/main/web-install.sh?v=$(date +%s)&r=$RANDOM\" | bash\n```\n\nThis automatically:\n- \u2705 Installs the package\n- \u2705 Configures Claude Code status bar\n- \u2705 Sets up shell aliases\n- \u2705 Just restart Claude Code and you're done!\n\n> \ud83d\udca1 **After installation:** Restart Claude Code and say something to see your usage!\n\n## \ud83d\udce6 Alternative Install Methods\n\n```bash\n# PyPI\npip install claude-statusbar\n\n# uv (fast)\nuv tool install claude-statusbar\n\n# pipx (isolated)\npipx install claude-statusbar\n```\n\n## \ud83d\ude80 Usage\n\n```bash\nclaude-statusbar # or cs for short\n```\n\nOutput: `\ud83d\udd0b T:48.0k/133.3k | $:59.28/90.26 | \ud83e\udd16opusplan | \u23f1\ufe0f31m | Usage:16.5%`\n\n- **T**: Token usage (current/limit)\n- **$**: Cost in USD (dynamic P90 limits)\n- **\ud83e\udd16**: Current Claude model\n- **\u23f1\ufe0f**: Time until reset\n- **Usage %**: Cost-based percentage, color-coded (\ud83d\udfe2 <30% | \ud83d\udfe1 30-70% | \ud83d\udd34 >70%)\n\n## \ud83d\udd27 Integrations\n\n**tmux status bar:**\n```bash\nset -g status-right '#(claude-statusbar)'\n```\n\n**zsh prompt:**\n```bash\nRPROMPT='$(claude-statusbar)'\n```\n\n## \ud83d\udd04 Upgrading\n\n### Automatic Updates (Recommended)\nThe tool automatically checks for updates once per day and upgrades itself. No action needed! \ud83c\udf89\n\nWhen an update is available, you'll see: `\ud83d\udd04 Upgraded from v1.0.0 to v1.1.0`\n\n### Manual Upgrade\nIf automatic upgrade fails, you can manually update:\n\n```bash\n# Re-run the installer (recommended - always gets latest)\ncurl -fsSL \"https://raw.githubusercontent.com/leeguooooo/claude-code-usage-bar/main/web-install.sh?v=$(date +%s)\" | bash\n\n# Or upgrade via package manager:\n# If installed with pip\npip install --upgrade claude-statusbar\n\n# If installed with pipx \npipx upgrade claude-statusbar\n\n# If installed with uv\nuv tool upgrade claude-statusbar\n```\n\n**Note:** After upgrading, restart Claude Code to use the new version.\n\n## \ud83d\udc96 Support\n\nIf you find this tool helpful, consider:\n- \u2b50 Star this repo\n- \ud83d\udc96 Sponsor via GitHub\n- \ud83d\udc1b Report issues\n\n## \ud83d\udcc4 License\n\nMIT\n\n## \u2b50 Star History\n\n[](https://star-history.com/#leeguooooo/claude-code-usage-bar&Date)\n\n---\n\n*Built on [Claude Monitor](https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor) by [@Maciek-roboblog](https://github.com/Maciek-roboblog)*\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Lightweight status bar monitor for Claude AI token usage",
"version": "1.2.2",
"project_urls": {
"Homepage": "https://github.com/leeguooooo/claude-code-usage-bar",
"Issues": "https://github.com/leeguooooo/claude-code-usage-bar/issues",
"Repository": "https://github.com/leeguooooo/claude-code-usage-bar"
},
"split_keywords": [
"claude",
" ai",
" monitoring",
" statusbar",
" token-usage"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ecde3320270c7a7161bf87e22492aca8d1af788ad1a17d16d02a82db775ad497",
"md5": "28f7fe962b828ac4f001d87fc179a060",
"sha256": "820ed896965aad0c982574cddeac092cc6409fa55b220eb4df631ad7ed8ed4b8"
},
"downloads": -1,
"filename": "claude_statusbar-1.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "28f7fe962b828ac4f001d87fc179a060",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 12114,
"upload_time": "2025-09-03T02:52:20",
"upload_time_iso_8601": "2025-09-03T02:52:20.682243Z",
"url": "https://files.pythonhosted.org/packages/ec/de/3320270c7a7161bf87e22492aca8d1af788ad1a17d16d02a82db775ad497/claude_statusbar-1.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c943f36cf4cabf08e94c3a41de06030047e1b4b4db9649cda71ac8935e0fe11d",
"md5": "342818e28c00d8034775091d5cc4e1ae",
"sha256": "a83f9fc312277fdaf6100469efaceaa28c5d5a7686f76d7828409fbed21db0d4"
},
"downloads": -1,
"filename": "claude_statusbar-1.2.2.tar.gz",
"has_sig": false,
"md5_digest": "342818e28c00d8034775091d5cc4e1ae",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 12442,
"upload_time": "2025-09-03T02:52:21",
"upload_time_iso_8601": "2025-09-03T02:52:21.924479Z",
"url": "https://files.pythonhosted.org/packages/c9/43/f36cf4cabf08e94c3a41de06030047e1b4b4db9649cda71ac8935e0fe11d/claude_statusbar-1.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-03 02:52:21",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "leeguooooo",
"github_project": "claude-code-usage-bar",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "claude-statusbar"
}
JSON
