claude-code-status-line 1.2.7

# 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](https://ndave92.github.io/claude-code-status-line/) for easy installation**

<img width="904" height="99" alt="Claude Code Status Line Screenshot" src="https://github.com/user-attachments/assets/bbf1173a-e77b-4ea2-a1fe-3bd3868779d1" />

## ✨ 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:**
```bash
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):**
```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**](https://ndave92.github.io/claude-code-status-line/) - Quick install and overview

Complete documentation is available in the [**GitHub Wiki**](https://github.com/ndave92/claude-code-status-line/wiki):

- 📦 [**Installation Guide**](https://github.com/ndave92/claude-code-status-line/wiki/Installation-Guide) - All installation methods
- ⚙️ [**Configuration Reference**](https://github.com/ndave92/claude-code-status-line/wiki/Configuration-Reference) - Complete config options
- 🎨 [**Customization Examples**](https://github.com/ndave92/claude-code-status-line/wiki/Customization-Examples) - Themes and styling
- 🔧 [**Troubleshooting**](https://github.com/ndave92/claude-code-status-line/wiki/Troubleshooting) - Common issues and solutions
- ⚠️ [**Known Issues**](https://github.com/ndave92/claude-code-status-line/wiki/Known-Issues) - Limitations and platform notes
- 🔄 [**Updating**](https://github.com/ndave92/claude-code-status-line/wiki/Updating) - How to upgrade
- 💻 [**Development**](https://github.com/ndave92/claude-code-status-line/wiki/Development) - Contributing and building from source

## 🆘 Quick Help

**Customize settings:**
```
/customize-statusline
```

**Update to latest version:**
```
/update-statusline
```

**Uninstall completely:**
```
/uninstall-statusline
```

**Check version:**
```bash
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](https://github.com/ndave92/claude-code-status-line/wiki/Known-Issues) for details and workarounds.

## 🤝 Contributing

Contributions are welcome! Please see the [Development Guide](https://github.com/ndave92/claude-code-status-line/wiki/Development) in the wiki.

## 📄 License

MIT License - see [LICENSE](https://github.com/ndave92/claude-code-status-line/blob/master/LICENSE) file for details.

---

**Made with ❤️ for the Claude Code community**