https://github.com/a692570/gauge
claude-pulse fork: context window used/remaining on line 2, Claude Code stdin fix
https://github.com/a692570/gauge
anthropic claude claude-code developer-tools productivity python status-bar terminal
Last synced: 2 months ago
JSON representation
claude-pulse fork: context window used/remaining on line 2, Claude Code stdin fix
- Host: GitHub
- URL: https://github.com/a692570/gauge
- Owner: a692570
- Created: 2026-04-09T07:11:00.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-09T07:25:41.000Z (3 months ago)
- Last Synced: 2026-04-09T09:15:39.018Z (3 months ago)
- Topics: anthropic, claude, claude-code, developer-tools, productivity, python, status-bar, terminal
- Language: Python
- Size: 53.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# gauge
A live status bar for Claude Code. Know your session, weekly budget, and context window at a glance — without opening a browser tab or guessing.
```
Session ──────────── 8% 4h 52m | Weekly ━─────────── 5% R:Tue 9am | Sonnet ━─────────── 8% | Off-Peak ✓
Context ━━━───────── 29% 58k • 71% 142k left
```
Line 1 tracks session burn, weekly rolling window, and Sonnet model usage — with reset times and a peak-hours indicator. Line 2 shows how deep into the context window the current conversation is.
## Install
```bash
git clone https://github.com/a692570/gauge ~/.gauge
python3 ~/.gauge/claude_status.py --install
python3 ~/.gauge/claude_status.py --context-format full
```
Restart Claude Code. The bar shows up automatically on every interaction.
Requires Python 3.12+. On macOS: `brew install python@3.13`
## Configure
```bash
# Themes (default, ocean, sunset, ember, frost, candy, neon, pride, mono, rainbow)
python3 ~/.gauge/claude_status.py --theme ember
# Bar style
python3 ~/.gauge/claude_status.py --bar-style dot
# Peak hours window (the 2x token consumption period)
python3 ~/.gauge/claude_status.py --peak-hours 13:00-19:00
# Hide sections you don't need
python3 ~/.gauge/claude_status.py --hide cost
python3 ~/.gauge/claude_status.py --hide lines
```
## Why it exists
Claude Code's session and weekly limits reset quietly. Running hard into a wall mid-conversation — then waiting for a reset — breaks flow. Gauge surfaces the numbers so you can pace yourself without thinking about it.
The context bar is the other half. Long sessions drift toward the limit without any warning. Seeing `29% 58k • 71% 142k left` is a lot more actionable than noticing the model getting weird.
## License
MIT