claude-code-status-line
| Crates.io | claude-code-status-line |
| lib.rs | claude-code-status-line |
| version | 1.2.8 |
| created_at | 2025-12-30 14:50:20.546904+00 |
| updated_at | 2026-01-14 09:26:08.793177+00 |
| description | A configurable status line for Claude Code with powerline arrows, context tracking, and quota monitoring |
| homepage | |
| repository | https://github.com/ndave92/claude-code-status-line |
| max_upload_size | |
| id | 2012759 |
| size | 250,963 |
David Nagy (ndave92)
documentation
README
Claude Code Status Line
A beautiful, configurable status line for Claude Code that displays workspace info, git status, model name, context usage, quota limits with timers, and optional API costs.
🌐 Visit the official site for easy installation
✨ Features
- 📊 Rich Information Display - Working directory, git branch, model name, context usage, quota tracking (5h/7d)
- 🎨 Fully Customizable - Per-section colors, Powerline arrows or custom separators, multiline mode
- 📱 Responsive Design - Automatically drops low-priority sections on narrow terminals
- 🔐 Secure Token Management - macOS Keychain, system keyring, or environment variables
- 🚀 Easy Installation - One-line installer for all platforms (macOS, Linux, Windows)
🚀 Quick Start
Install the automated installer with one command:
macOS / Linux:
mkdir -p ~/.claude/commands && curl -o ~/.claude/commands/install-statusline.md https://raw.githubusercontent.com/ndave92/claude-code-status-line/master/.claude/commands/install-statusline.md
Windows (PowerShell):
New-Item -Path "$env:USERPROFILE\.claude\commands" -ItemType Directory -Force; Invoke-WebRequest -Uri "https://raw.githubusercontent.com/ndave92/claude-code-status-line/master/.claude/commands/install-statusline.md" -OutFile "$env:USERPROFILE\.claude\commands\install-statusline.md"
Then restart Claude Code and run:
/install-statusline
📚 Documentation
- 🌐 Official Site - Quick install and overview
Complete documentation is available in the GitHub Wiki:
- 📦 Installation Guide - All installation methods
- ⚙️ Configuration Reference - Complete config options
- 🎨 Customization Examples - Themes and styling
- 🔧 Troubleshooting - Common issues and solutions
- ⚠️ Known Issues - Limitations and platform notes
- 🔄 Updating - How to upgrade
- 💻 Development - Contributing and building from source
🆘 Quick Help
Customize settings:
/customize-statusline
Update to latest version:
/update-statusline
Uninstall completely:
/uninstall-statusline
Check version:
claude-code-status-line --version
Configuration files:
~/.claude/statusline/settings.json- Feature toggles and settings~/.claude/statusline/colors.json- Color customization
⚠️ Known Issues
- Notification overlap - Claude Code notifications may obstruct the statusline
- Powerline characters - Require special fonts; not supported in default terminals
See Known Issues for details and workarounds.
🤝 Contributing
Contributions are welcome! Please see the Development Guide in the wiki.
📄 License
MIT License - see LICENSE file for details.
Made with ❤️ for the Claude Code community