CreatmanCEO/claude-statusline
CLILive in production🇬🇧 English · 🇷🇺 Русский
Smart status line for Claude Code — model, cost, context, usage limits, VPS health with auto-focus. Pure bash + jq, no Node.js. Featured on Habr (9.3K reads).
- Shell100.0%
1 Review
claude-statusline is a focused, practical developer tool with a clear audience: Claude Code users who want session state, context pressure, cost, quota, git status, and server health visible without leaving the terminal. The README does a strong job of explaining not just what the tool shows, but why the architecture is shaped the way it is. The split between statusline.sh and vps-poller.sh is especially sensible: keeping SSH polling out of the prompt-time render path and reading cached /tmp/vps-*.json files is the right tradeoff for a status line that may run constantly.
The project also feels more mature than its small size suggests. It has an installer, uninstall path, config file, Russian README, MIT license, contribution guide, changelog, screenshots, platform notes, troubleshooting, and a GitHub Actions workflow that checks shell syntax, ShellCheck errors, docs assets, internal links, SVG validity, and sourceability of statusline.conf. The implementation is readable Bash and the feature set is thoughtfully scoped.
The main improvement I’d suggest is adding a small test harness with mocked Claude Code JSON and mocked VPS cache files, so changes to parsing, colors, quota formatting, and focus detection can be verified without a live Claude session. For wider adoption, a first tagged release plus Homebrew/apt install notes would help. I’d also document the local-security assumptions around sourced config, /tmp cache/PID files, and StrictHostKeyChecking=no in VPS polling, since terminal power users will notice those details. Overall, this is a useful, well-documented personal tool that solves a real workflow problem with a refreshingly lightweight stack.
