{
  "markdown": "# Enhanced Status Line Plugin for Claude Code\n\n[![GitHub stars](https://img.shields.io/github/stars/deepan-g2/claude-statusline-plugin?style=social)](https://github.com/deepan-g2/claude-statusline-plugin/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/deepan-g2/claude-statusline-plugin?style=social)](https://github.com/deepan-g2/claude-statusline-plugin/network/members)\n[![GitHub watchers](https://img.shields.io/github/watchers/deepan-g2/claude-statusline-plugin?style=social)](https://github.com/deepan-g2/claude-statusline-plugin/watchers)\n[![Visitor Count](https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Fdeepan-g2%2Fclaude-statusline-plugin&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=visitors&edge_flat=false)](https://hits.seeyoufarm.com)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Version](https://img.shields.io/github/v/release/deepan-g2/claude-statusline-plugin)](https://github.com/deepan-g2/claude-statusline-plugin/releases)\n\nA beautiful, informative status line for Claude Code that displays real-time session metrics, git status, token usage, and more.\n\n## 🎨 Features\n\n### Core Metrics\n- **📁 Directory Display** - Current working directory (always shown)\n- **⎇ Git Integration** - Branch name, uncommitted changes (*), unpushed commits (↑N)\n- **◉ Smart Context Tracking** - Percentage + actual token count with color coding\n  - Green (< 60%) - All good\n  - Yellow (60-80%) - Watch it\n  - Orange (> 80%) - Warning!\n- **⏱ Session Duration** - Track how long you've been working\n- **+/- Code Changes** - Lines added and removed in session\n- **💰 Cost Monitoring** - Real-time cost tracking\n- **⚡ API Call Counter** - Number of API requests in session (NEW in v1.2.0)\n- **📦 Cache Hit Ratio** - Prompt caching efficiency (NEW in v1.2.0, optional)\n\n### Customization\n- **10 Pre-built Themes** - Dracula, Nord, Cyberpunk, Solarized, Gruvbox, Ocean, Sunset, Monochrome, Matrix\n- **Feature Toggles** - Show/hide any component\n- **256 Color Support** - Full terminal color customization\n- **Persistent Config** - Your preferences saved across sessions\n\n## 📸 Preview\n\n![Status Line Preview](images/statusline-preview.png)\n\n**Example output:**\n```\n📁 myproject │ ⎇ main*↑3 │ ◉ 45% (450K) │ ⏱ 1h30m │ +320/-145 │ $0.450 │ ⚡25 │ 📦85%\n```\n\n**With cache tracking enabled:**\n- ⚡25 = 25 API calls\n- 📦85% = 85% cache hit rate (green = good caching!)\n\n## 📦 Installation\n\n### From GitHub (Recommended)\n\n```bash\n# Add the plugin marketplace\n/plugin marketplace add deepan-g2/claude-statusline-plugin\n\n# Install the plugin\n/plugin install enhanced-statusline@deepan-statusline-plugins\n```\n\n### 🔄 Updating to Latest Version\n\nIf you already have the plugin installed, update to get new features:\n\n```bash\n# Update to latest version\nclaude plugin update enhanced-statusline@deepan-statusline-plugins\n```\n\nOr enable auto-updates (inside Claude Code):\n```bash\n/plugin\n# Go to: Marketplaces → deepan-statusline-plugins → Enable auto-update\n```\n\n**Current Version:** v1.2.0 (Released: 2026-01-11)\n**Previous Version:** v1.0.0\n\nSee [CHANGELOG.md](CHANGELOG.md) for all version changes.\n\n### Local Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/deepan-g2/claude-statusline-plugin.git\ncd claude-statusline-plugin\n\n# Test locally\nclaude --plugin-dir ./\n```\n\n## 🚀 Quick Start\n\nAfter installation, activate the status line:\n\n```bash\n# Inside Claude Code\n/enhanced-statusline:setup-statusline\n```\n\nOr manually add to your `~/.claude/settings.json`:\n\n```json\n{\n  \"statusLine\": {\n    \"type\": \"command\",\n    \"command\": \"~/.claude/plugins/enhanced-statusline/scripts/statusline.sh\",\n    \"padding\": 0\n  }\n}\n```\n\nThen restart your Claude Code session!\n\n## 🎨 Customization\n\n### Change Colors\n\nEdit the script at `scripts/statusline.sh` (lines 86-96):\n\n```bash\nCYAN=\"\\033[38;5;87m\"      # Change to any 0-255 color\nGREEN=\"\\033[38;5;46m\"\nYELLOW=\"\\033[38;5;228m\"\nORANGE=\"\\033[38;5;214m\"\nPURPLE=\"\\033[38;5;141m\"\n```\n\n### Popular Color Schemes\n\n**Dracula Theme:**\n```bash\nCYAN=\"\\033[38;5;117m\"\nGREEN=\"\\033[38;5;84m\"\nORANGE=\"\\033[38;5;215m\"\nPURPLE=\"\\033[38;5;141m\"\n```\n\n**Ocean Blue:**\n```bash\nCYAN=\"\\033[38;5;81m\"\nGREEN=\"\\033[38;5;48m\"\nORANGE=\"\\033[38;5;116m\"\nPURPLE=\"\\033[38;5;69m\"\n```\n\n### View All Colors\n\n```bash\nfor i in {0..255}; do\n  echo -e \"\\033[38;5;${i}m${i}\\033[0m\"\ndone\n```\n\n## 📚 Available Commands\n\n### 🚀 Method 1: Direct CLI (Fastest - Recommended!)\n\nUse the included CLI tool **outside of Claude** for instant results:\n\n```bash\n# Create an alias (add to ~/.zshrc or ~/.bashrc)\nalias statusline-cli='~/.claude/plugins/cache/deepan-statusline-plugins/enhanced-statusline/*/scripts/statusline-cli.sh'\n\n# Then use it:\nstatusline-cli themes list          # List all themes\nstatusline-cli themes apply dracula # Apply Dracula theme\nstatusline-cli toggle git           # Toggle git display\nstatusline-cli config show          # Show current config\n```\n\n**Why use this?** Instant execution, no Claude overhead, no autocomplete errors!\n\n### 🐌 Method 2: Plugin Commands (Inside Claude)\n\nIf you prefer to use commands inside Claude Code:\n\n**Setup & Configuration:**\n- `/enhanced-statusline:setup-statusline` - Initial status line configuration\n- `/enhanced-statusline:show-config` - View current theme and settings\n\n**Theme Management:**\n- `/enhanced-statusline:theme` - Switch between 10 pre-built themes\n\n**Feature Toggles:**\n- `/enhanced-statusline:toggle-git` - Show/hide git branch and status\n- `/enhanced-statusline:toggle-cost` - Show/hide cost monitoring\n- `/enhanced-statusline:toggle-duration` - Show/hide session duration\n\n**Note:** Plugin commands may be slower as they go through Claude's command parser.\n\n## 🔧 Requirements\n\n- Claude Code CLI\n- `jq` (for JSON parsing)\n- `bc` (for calculations)\n- Git (optional, for git status features)\n\nInstall dependencies:\n\n```bash\n# macOS\nbrew install jq bc\n\n# Linux\napt-get install jq bc\n```\n\n## 📖 Documentation\n\n### Status Line Components\n\n| Component | Description | Example |\n|-----------|-------------|---------|\n| 📁 Directory | Current folder name | `📁 myproject` |\n| ⎇ Git | Branch + status | `⎇ main*↑3` |\n| ◉ Context | Token usage % + count | `◉ 45% (450K)` |\n| ⏱ Duration | Session time | `⏱ 1h30m` |\n| +/- Lines | Code changes | `+320/-145` |\n| 💰 Cost | Session cost | `$0.450` |\n\n### Git Status Indicators\n\n- `*` - Uncommitted changes present\n- `↑N` - N unpushed commits\n- No indicator - Clean working tree\n\n### Context Warning Levels\n\n- **Green ◉** - Less than 60% context used\n- **Yellow ◉** - 60-80% context used\n- **Orange ⚠** - More than 80% context used (consider compacting)\n\n## 🛠 Troubleshooting\n\n### Update Not Working?\n\nIf `claude plugin update` doesn't show the latest version:\n\n```bash\n# Option 1: Uninstall and reinstall (Recommended)\nclaude plugin uninstall enhanced-statusline\nclaude plugin install enhanced-statusline@deepan-statusline-plugins\n\n# Option 2: Force marketplace refresh\n/plugin marketplace remove deepan-statusline-plugins\n/plugin marketplace add deepan-g2/claude-statusline-plugin\nclaude plugin install enhanced-statusline@deepan-statusline-plugins\n\n# Option 3: Clear cache (if above don't work)\n# Exit Claude, then:\nrm -rf ~/.claude/plugins/cache/deepan-statusline-plugins\n# Restart Claude and reinstall\nclaude plugin install enhanced-statusline@deepan-statusline-plugins\n```\n\n### New Commands Not Showing?\n\nAfter updating to v1.2.0, if new commands aren't available:\n- **Restart Claude Code completely** (exit and start new session)\n- Verify you're on v1.2.0: Check `~/.claude/plugins/installed_plugins.json`\n- The new commands should appear: `/enhanced-statusline:theme`, `/enhanced-statusline:toggle-git`, etc.\n\n### Colors not showing?\n```bash\n# Check terminal color support\necho $TERM  # Should be xterm-256color or similar\nexport TERM=xterm-256color\n```\n\n### jq not found?\n```bash\n# Install jq\nbrew install jq  # macOS\napt-get install jq  # Linux\n```\n\n### Status line not updating?\n- Restart Claude Code session\n- Check script permissions: `chmod +x ~/.claude/plugins/cache/*/enhanced-statusline/*/scripts/statusline.sh`\n- Test manually: `echo '{}' | ~/.claude/statusline.sh`\n\n### Theme Command Error?\nIf you get an error running `/enhanced-statusline:theme`:\n- Make sure you're on v1.2.0 (see \"Update Not Working\" above)\n- Check that `scripts/themes.json` exists in your plugin directory\n- Try running setup again: `/enhanced-statusline:setup-statusline`\n\n## 🤝 Contributing\n\nContributions welcome! Please:\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📝 License\n\nMIT License - feel free to use and modify!\n\n## 🌟 Credits\n\nCreated by Deepan Kumar ([@deepan-g2](https://github.com/deepan-g2)). Inspired by Oh-My-Zsh themes and Starship prompt.\n\n## 📮 Support\n\n- Report issues: [GitHub Issues](https://github.com/deepan-g2/claude-statusline-plugin/issues)\n- Discussions: [GitHub Discussions](https://github.com/deepan-g2/claude-statusline-plugin/discussions)\n- Documentation: [Wiki](https://github.com/deepan-g2/claude-statusline-plugin/wiki)\n\n---\n\nMade with ❤️ for the Claude Code community\n",
  "bytes": 9364,
  "sha": "e21750cce1b2522ad4104fab61bba5de23c17120e581281e7eeba1aa482477de",
  "repo_slug": "deepan-g2/claude-statusline-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_deepan_g2_claude_statusline_plugin_enhan_0f7d1747/readme"
}