https://github.com/leeguooooo/claude-code-usage-bar
Real‑time statusline for Claude Code: token usage, remaining budget, burn rate, and depletion time
https://github.com/leeguooooo/claude-code-usage-bar
Last synced: about 1 month ago
JSON representation
Real‑time statusline for Claude Code: token usage, remaining budget, burn rate, and depletion time
- Host: GitHub
- URL: https://github.com/leeguooooo/claude-code-usage-bar
- Owner: leeguooooo
- Created: 2025-08-20T01:43:23.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-08-20T02:27:45.000Z (about 2 months ago)
- Last Synced: 2025-08-20T04:40:59.498Z (about 2 months ago)
- Language: Python
- Size: 267 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-claude-code - **claude-code-usage-bar**
README
# 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 | 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/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:**
```bash
set -g status-right '#(claude-statusbar)'
```
**zsh prompt:**
```bash
RPROMPT='$(claude-statusbar)'
```
## 💖 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)*