# Claude Statusline
Real-time session tracking and analytics for Claude Code with 100+ powerline themes and comprehensive analytics.
## Features
### Core Features
- 📊 **Real-time Monitoring** - Track active sessions with live updates
- 💰 **Cost Tracking** - Accurate cost calculation based on official pricing
- 🤖 **Multi-Model Support** - Track Opus, Sonnet, and Haiku models
- 📁 **Git Integration** - Shows branch info and repository status
- 💻 **System Info** - CPU, memory, and folder information
- ⚡ **Lightweight** - Minimal dependencies (only psutil)
- 📦 **Easy Installation** - Available as a Python package
### Powerline Themes (v1.9.1 - NEW!)
- 🎨 **100 Professional Themes** - Carefully designed powerline themes with logical widget grouping
- 🌈 **Advanced RGB Colors** - True color output with soft, pleasant color schemes
- 🔧 **Interactive Theme Browser** - Navigate themes with live preview and search
- 🎯 **Custom Theme Builder** - Create and save your own powerline designs
- ⚡ **Real-time Data** - Live token counts, cache efficiency, and session metrics
- 📱 **Smart Widget Organization** - Related widgets grouped together (tokens, time, etc.)
- 📊 **Two-Line Display** - Progress bar on second line showing session completion (◼◻)
- ⧂ **Visual Enhancements** - Refined Unicode characters for softer appearance
### Analytics & Reporting
- 📈 **Advanced Usage Analytics** - Comprehensive productivity metrics and insights
- 📊 **Trend Analysis** - Usage trends, productivity patterns, and optimization recommendations
- 🏥 **Health Monitoring** - System health diagnostics and performance monitoring
- 💹 **Budget Management** - Set spending limits and track budget compliance
- 📊 **Usage Patterns Analysis** - Behavioral insights and optimization recommendations
- 📉 **Cost Forecasting** - Predict future costs based on usage trends
- 📋 **Export Reports** - Generate detailed reports for external analysis
- 🚨 **Smart Alerts** - Budget warnings and usage anomaly detection
- 🎯 **Unified CLI** - Single command interface for all features
## Quick Start
### Install from PyPI
```bash
# Install the package
pip install claude-statusline
# View current status
claude-statusline status
# Browse themes interactively
claude-statusline theme
# Start background daemon
claude-statusline daemon --start
# View analytics
claude-statusline analytics
```
### Commands Overview
```bash
# Core Commands
claude-statusline status # Show current session status
claude-statusline daemon --start # Start background monitoring
claude-statusline theme # Interactive theme browser
claude-statusline rebuild # Rebuild database from logs
# Analytics Commands
claude-statusline analytics # Advanced usage analytics
claude-statusline trends # Usage trends and patterns
claude-statusline health # System health monitoring
claude-statusline budget # Budget management
claude-statusline sessions # Session analysis
claude-statusline costs # Cost analysis
claude-statusline daily # Daily reports
claude-statusline heatmap # Activity heatmaps
claude-statusline summary # Summary statistics
# Utilities
claude-statusline update-prices # Update model pricing
claude-statusline verify # Verify cost calculations
claude-statusline rotate # Theme rotation settings
```
## Theme System
The powerline theme system provides 100 professionally designed themes with:
- **Smart Widget Grouping** - Related widgets (tokens, time, etc.) are consecutive
- **Pleasant Color Schemes** - Soft, eye-friendly RGB colors instead of harsh tones
- **Nerd Font Icons** - Creative, diverse icons for each widget type
- **Live Preview** - See real data in themes before applying
- **Custom Themes** - Build and save your own designs
- **Interactive Browser** - Navigate with simple commands (n/p for next/previous)
### Theme Browser Commands
```
n/j = Next theme p/k = Previous theme ENTER = Apply theme
r = Random theme g = Go to number q = Quit
+10 = Jump forward -10 = Jump back / = Search
b = Theme builder
```
## Analytics Features
### Trend Analysis
- Usage patterns over time
- Productivity insights
- Model efficiency analysis
- Peak usage hours identification
- Seasonal trends detection
### Health Monitoring
- System performance metrics
- Database health checks
- Daemon status monitoring
- Performance bottleneck detection
### Budget Management
- Set monthly/weekly spending limits
- Real-time budget tracking
- Overspend warnings
- Cost projection alerts
## Installation
### From PyPI (Recommended)
```bash
pip install claude-statusline
```
### From Source
```bash
git clone https://github.com/yourusername/claude-statusline.git
cd claude-statusline
pip install -e .
```
## Configuration
The tool automatically creates configuration in `~/.claude/data-statusline/`:
- `smart_sessions_db.json` - Session database
- `theme_config.json` - Current theme settings
- `daemon_status.json` - Background daemon status
- `config.json` - General configuration
- `prices.json` - Model pricing data
## Requirements
- Python 3.8+
- Claude Code (for session data)
- psutil (automatically installed)
## Architecture
```
Claude Code → JSONL Logs → Database Builder → Analytics Tools
↓
Session Database ← Background Daemon
↓
Statusline Display ← Theme System
```
## Data Privacy
- All data stays local on your machine
- No network requests except for price updates
- Session data derived only from Claude Code logs
- No telemetry or tracking
## Contributing
1. Fork the repository
2. Create a feature branch
3. Make changes
4. Add tests if applicable
5. Submit a pull request
## License
MIT License - see LICENSE file for details.
## Changelog
### v1.9.0 (Latest)
- **NEW**: 100 professional powerline themes with smart widget grouping
- **NEW**: Interactive theme browser with live preview and search
- **NEW**: Custom theme builder for creating personalized designs
- **NEW**: Advanced RGB color system with soft, pleasant color schemes
- **NEW**: Comprehensive trend analysis and productivity insights
- **NEW**: System health monitoring and diagnostics
- **IMPROVED**: Unified powerline system replaces all previous theme systems
- **IMPROVED**: Token widgets now grouped together logically
- **IMPROVED**: Cleaned up codebase by removing 16 obsolete files
- **FIXED**: Better Unicode and nerd font support across platforms
- **FIXED**: Improved theme organization and consistency
### v1.8.0
- Advanced analytics and budget management
- Multi-model cost tracking improvements
- Enhanced session detection
- Performance optimizations
## Support
For issues, feature requests, or questions:
- Create an issue on GitHub
- Check the documentation in the `/docs` folder
- Review the CLI help with `claude-statusline --help`
Raw data
{
"_id": null,
"home_page": "https://github.com/ersinkoc/claude-statusline",
"name": "claude-statusline",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "claude, claude-code, statusline, monitoring, analytics, ai, anthropic, session-tracking, cost-tracking, developer-tools",
"author": "Ersin Ko\u00e7",
"author_email": "Ersin Ko\u00e7 <ersinkoc@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/0d/4f/d7ed1660f2d52094702eb69a022d633269faac112fa41085542465572da5/claude_statusline-1.9.1.tar.gz",
"platform": null,
"description": "# Claude Statusline\r\n\r\nReal-time session tracking and analytics for Claude Code with 100+ powerline themes and comprehensive analytics.\r\n\r\n\r\n\r\n\r\n\r\n\r\n## Features\r\n\r\n### Core Features\r\n- \ud83d\udcca **Real-time Monitoring** - Track active sessions with live updates\r\n- \ud83d\udcb0 **Cost Tracking** - Accurate cost calculation based on official pricing\r\n- \ud83e\udd16 **Multi-Model Support** - Track Opus, Sonnet, and Haiku models\r\n- \ud83d\udcc1 **Git Integration** - Shows branch info and repository status\r\n- \ud83d\udcbb **System Info** - CPU, memory, and folder information\r\n- \u26a1 **Lightweight** - Minimal dependencies (only psutil)\r\n- \ud83d\udce6 **Easy Installation** - Available as a Python package\r\n\r\n### Powerline Themes (v1.9.1 - NEW!)\r\n- \ud83c\udfa8 **100 Professional Themes** - Carefully designed powerline themes with logical widget grouping\r\n- \ud83c\udf08 **Advanced RGB Colors** - True color output with soft, pleasant color schemes\r\n- \ud83d\udd27 **Interactive Theme Browser** - Navigate themes with live preview and search\r\n- \ud83c\udfaf **Custom Theme Builder** - Create and save your own powerline designs\r\n- \u26a1 **Real-time Data** - Live token counts, cache efficiency, and session metrics\r\n- \ud83d\udcf1 **Smart Widget Organization** - Related widgets grouped together (tokens, time, etc.)\r\n- \ud83d\udcca **Two-Line Display** - Progress bar on second line showing session completion (\u25fc\u25fb)\r\n- \u29c2 **Visual Enhancements** - Refined Unicode characters for softer appearance\r\n\r\n### Analytics & Reporting\r\n- \ud83d\udcc8 **Advanced Usage Analytics** - Comprehensive productivity metrics and insights\r\n- \ud83d\udcca **Trend Analysis** - Usage trends, productivity patterns, and optimization recommendations\r\n- \ud83c\udfe5 **Health Monitoring** - System health diagnostics and performance monitoring\r\n- \ud83d\udcb9 **Budget Management** - Set spending limits and track budget compliance\r\n- \ud83d\udcca **Usage Patterns Analysis** - Behavioral insights and optimization recommendations\r\n- \ud83d\udcc9 **Cost Forecasting** - Predict future costs based on usage trends\r\n- \ud83d\udccb **Export Reports** - Generate detailed reports for external analysis\r\n- \ud83d\udea8 **Smart Alerts** - Budget warnings and usage anomaly detection\r\n- \ud83c\udfaf **Unified CLI** - Single command interface for all features\r\n\r\n## Quick Start\r\n\r\n### Install from PyPI\r\n\r\n```bash\r\n# Install the package\r\npip install claude-statusline\r\n\r\n# View current status\r\nclaude-statusline status\r\n\r\n# Browse themes interactively\r\nclaude-statusline theme\r\n\r\n# Start background daemon\r\nclaude-statusline daemon --start\r\n\r\n# View analytics\r\nclaude-statusline analytics\r\n```\r\n\r\n### Commands Overview\r\n\r\n```bash\r\n# Core Commands\r\nclaude-statusline status # Show current session status\r\nclaude-statusline daemon --start # Start background monitoring\r\nclaude-statusline theme # Interactive theme browser\r\nclaude-statusline rebuild # Rebuild database from logs\r\n\r\n# Analytics Commands\r\nclaude-statusline analytics # Advanced usage analytics\r\nclaude-statusline trends # Usage trends and patterns\r\nclaude-statusline health # System health monitoring\r\nclaude-statusline budget # Budget management\r\nclaude-statusline sessions # Session analysis\r\nclaude-statusline costs # Cost analysis\r\nclaude-statusline daily # Daily reports\r\nclaude-statusline heatmap # Activity heatmaps\r\nclaude-statusline summary # Summary statistics\r\n\r\n# Utilities\r\nclaude-statusline update-prices # Update model pricing\r\nclaude-statusline verify # Verify cost calculations\r\nclaude-statusline rotate # Theme rotation settings\r\n```\r\n\r\n## Theme System\r\n\r\nThe powerline theme system provides 100 professionally designed themes with:\r\n\r\n- **Smart Widget Grouping** - Related widgets (tokens, time, etc.) are consecutive\r\n- **Pleasant Color Schemes** - Soft, eye-friendly RGB colors instead of harsh tones\r\n- **Nerd Font Icons** - Creative, diverse icons for each widget type\r\n- **Live Preview** - See real data in themes before applying\r\n- **Custom Themes** - Build and save your own designs\r\n- **Interactive Browser** - Navigate with simple commands (n/p for next/previous)\r\n\r\n### Theme Browser Commands\r\n\r\n```\r\nn/j = Next theme p/k = Previous theme ENTER = Apply theme\r\nr = Random theme g = Go to number q = Quit\r\n+10 = Jump forward -10 = Jump back / = Search\r\nb = Theme builder\r\n```\r\n\r\n## Analytics Features\r\n\r\n### Trend Analysis\r\n- Usage patterns over time\r\n- Productivity insights\r\n- Model efficiency analysis\r\n- Peak usage hours identification\r\n- Seasonal trends detection\r\n\r\n### Health Monitoring\r\n- System performance metrics\r\n- Database health checks\r\n- Daemon status monitoring\r\n- Performance bottleneck detection\r\n\r\n### Budget Management\r\n- Set monthly/weekly spending limits\r\n- Real-time budget tracking\r\n- Overspend warnings\r\n- Cost projection alerts\r\n\r\n## Installation\r\n\r\n### From PyPI (Recommended)\r\n```bash\r\npip install claude-statusline\r\n```\r\n\r\n### From Source\r\n```bash\r\ngit clone https://github.com/yourusername/claude-statusline.git\r\ncd claude-statusline\r\npip install -e .\r\n```\r\n\r\n## Configuration\r\n\r\nThe tool automatically creates configuration in `~/.claude/data-statusline/`:\r\n\r\n- `smart_sessions_db.json` - Session database\r\n- `theme_config.json` - Current theme settings\r\n- `daemon_status.json` - Background daemon status\r\n- `config.json` - General configuration\r\n- `prices.json` - Model pricing data\r\n\r\n## Requirements\r\n\r\n- Python 3.8+\r\n- Claude Code (for session data)\r\n- psutil (automatically installed)\r\n\r\n## Architecture\r\n\r\n```\r\nClaude Code \u2192 JSONL Logs \u2192 Database Builder \u2192 Analytics Tools\r\n \u2193\r\n Session Database \u2190 Background Daemon\r\n \u2193\r\n Statusline Display \u2190 Theme System\r\n```\r\n\r\n## Data Privacy\r\n\r\n- All data stays local on your machine\r\n- No network requests except for price updates\r\n- Session data derived only from Claude Code logs\r\n- No telemetry or tracking\r\n\r\n## Contributing\r\n\r\n1. Fork the repository\r\n2. Create a feature branch\r\n3. Make changes\r\n4. Add tests if applicable\r\n5. Submit a pull request\r\n\r\n## License\r\n\r\nMIT License - see LICENSE file for details.\r\n\r\n## Changelog\r\n\r\n### v1.9.0 (Latest)\r\n- **NEW**: 100 professional powerline themes with smart widget grouping\r\n- **NEW**: Interactive theme browser with live preview and search\r\n- **NEW**: Custom theme builder for creating personalized designs\r\n- **NEW**: Advanced RGB color system with soft, pleasant color schemes\r\n- **NEW**: Comprehensive trend analysis and productivity insights\r\n- **NEW**: System health monitoring and diagnostics\r\n- **IMPROVED**: Unified powerline system replaces all previous theme systems\r\n- **IMPROVED**: Token widgets now grouped together logically\r\n- **IMPROVED**: Cleaned up codebase by removing 16 obsolete files\r\n- **FIXED**: Better Unicode and nerd font support across platforms\r\n- **FIXED**: Improved theme organization and consistency\r\n\r\n### v1.8.0\r\n- Advanced analytics and budget management\r\n- Multi-model cost tracking improvements\r\n- Enhanced session detection\r\n- Performance optimizations\r\n\r\n## Support\r\n\r\nFor issues, feature requests, or questions:\r\n- Create an issue on GitHub\r\n- Check the documentation in the `/docs` folder\r\n- Review the CLI help with `claude-statusline --help`\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Real-time session tracking and analytics for Claude Code",
"version": "1.9.1",
"project_urls": {
"Bug Tracker": "https://github.com/ersinkoc/claude-statusline/issues",
"Changelog": "https://github.com/ersinkoc/claude-statusline/blob/main/CHANGELOG.md",
"Documentation": "https://github.com/ersinkoc/claude-statusline/blob/main/README.md",
"Homepage": "https://github.com/ersinkoc/claude-statusline",
"Repository": "https://github.com/ersinkoc/claude-statusline"
},
"split_keywords": [
"claude",
" claude-code",
" statusline",
" monitoring",
" analytics",
" ai",
" anthropic",
" session-tracking",
" cost-tracking",
" developer-tools"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "0dfe26cc5cc308086808da6e53b11609eeadde030a3cefbc3aeb9e0a631d34b5",
"md5": "9ed265d391f247f43f73db05ec476503",
"sha256": "dfcd81c9fb61fd4d4844d8c9f8bc199fdd89f1525716df434431f4c24b84a88d"
},
"downloads": -1,
"filename": "claude_statusline-1.9.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9ed265d391f247f43f73db05ec476503",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 102178,
"upload_time": "2025-08-22T19:46:49",
"upload_time_iso_8601": "2025-08-22T19:46:49.549946Z",
"url": "https://files.pythonhosted.org/packages/0d/fe/26cc5cc308086808da6e53b11609eeadde030a3cefbc3aeb9e0a631d34b5/claude_statusline-1.9.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0d4fd7ed1660f2d52094702eb69a022d633269faac112fa41085542465572da5",
"md5": "c2b6135765ac877d667c69d8af6b36e2",
"sha256": "e189b1e0587826697e73517bc4fd3823a93000693a54f3700657af9a68cc3fe4"
},
"downloads": -1,
"filename": "claude_statusline-1.9.1.tar.gz",
"has_sig": false,
"md5_digest": "c2b6135765ac877d667c69d8af6b36e2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 102265,
"upload_time": "2025-08-22T19:46:50",
"upload_time_iso_8601": "2025-08-22T19:46:50.539640Z",
"url": "https://files.pythonhosted.org/packages/0d/4f/d7ed1660f2d52094702eb69a022d633269faac112fa41085542465572da5/claude_statusline-1.9.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-22 19:46:50",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ersinkoc",
"github_project": "claude-statusline",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "psutil",
"specs": [
[
">=",
"5.9.0"
]
]
},
{
"name": "colorama",
"specs": [
[
">=",
"0.4.6"
]
]
}
],
"lcname": "claude-statusline"
}
JSON
