feat(statusline): add real-time session visibility plugin

Add new statusline plugin inspired by claude-hud that provides:
- Real-time context usage tracking with visual health meter
- Active tool monitoring and completed tool aggregation
- Running agent visibility with execution times
- Task progress tracking from todo operations

Includes four slash commands:
- /statusline:status - Display metrics immediately
- /statusline:enable - Enable continuous monitoring
- /statusline:disable - Pause automatic updates
- /statusline:config - Interactive setup with interview-style questions

🤖 Generated with Claude Code

Co-Authored-By: duyetbot <duyetbot@users.noreply.github.com>

Author: duyet

.claude-plugin/marketplace.json

@@ -33,6 +33,11 @@
       "name": "interview",
       "source": "./interview",
       "description": "Conduct in-depth requirements interviews using Socratic questioning. Clarifies implementation details, edge cases, and tradeoffs before coding begins."
+    },
+    {
+      "name": "statusline",
+      "source": "./statusline",
+      "description": "Real-time visibility into Claude Code sessions showing context usage, active tools, and task progress. Inspired by claude-hud."
     }
   ]
 }

statusline/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "statusline",
+  "version": "1.0.0",
+  "description": "Real-time visibility into Claude Code sessions showing context usage, active tools, and task progress",
+  "author": {
+    "name": "duyet"
+  }
+}

statusline/README.md

@@ -0,0 +1,192 @@
+# Statusline
+
+A Claude Code plugin that provides real-time visibility into your coding session. Track context usage, active tools, running agents, and task progress at a glance.
+
+**Inspired by [claude-hud](https://github.com/jarrodwatts/claude-hud) — enhanced for the claude-plugins ecosystem.**
+
+## Overview
+
+Statusline keeps you informed about what's happening during your Claude Code session without interrupting your workflow. Get immediate feedback on:
+
+| Metric | Purpose |
+|--------|---------|
+| **Context Health** | Know exactly how much of your token window is in use |
+| **Active Tools** | See which tools Claude is using right now |
+| **Agent Tracking** | Monitor running agents and their execution time |
+| **Task Progress** | Track todo completion in real-time |
+
+## Installation
+
+Add the plugin to your Claude Code instance:
+
+```bash
+/plugin install statusline
+```
+
+Then enable monitoring:
+
+```bash
+/statusline:enable
+```
+
+## Quick Start
+
+### View Current Status
+Check your session metrics anytime:
+```bash
+/statusline:status
+```
+
+### Continuous Monitoring
+Enable automatic status updates (5-second interval by default):
+```bash
+/statusline:enable
+```
+
+### Custom Update Interval
+Set a custom monitoring interval (in seconds):
+```bash
+/statusline:enable 10
+```
+
+### Stop Monitoring
+Pause background updates while keeping the plugin active:
+```bash
+/statusline:disable
+```
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/statusline:status` | Display current session metrics immediately |
+| `/statusline:enable [interval]` | Enable real-time monitoring with optional custom interval |
+| `/statusline:disable` | Pause automatic status updates |
+
+## What Each Metric Shows
+
+### Context Window
+A visual progress bar showing your token usage with color coding:
+- 🟢 Green: 0-60% — Comfortable usage
+- 🟡 Yellow: 60-85% — Getting full
+- 🔴 Red: 85%+ — Approaching limit
+
+Example:
+```
+Context: ████░░░░░░ 45% (90,000 / 200,000 tokens)
+```
+
+### Active Tools
+Lists tools currently in use with operation counts:
+```
+Active Tools:
+  • Read (2 instances)
+  • Bash (1 instance)
+  • Glob (1 instance)
+```
+
+### Completed Tools
+Aggregated summary of completed tool operations:
+```
+Completed: ✓ Glob ×4 | ✓ Bash ×8 | ✓ Read ×12 | ✓ Edit ×3
+```
+
+### Running Agents
+Shows active agents with elapsed time:
+```
+Agents Running:
+  • Explore: Analyzing codebase structure (12s)
+  • code-reviewer: Reviewing authentication module (5s)
+```
+
+### Task Progress
+Real-time todo tracking:
+```
+Tasks: ⏳ 2 pending | 🔄 1 in progress | ✓ 5 completed (5/8 total)
+```
+
+### Session Duration
+Tracks how long your current session has been active:
+```
+Duration: 12m 34s
+```
+
+## Features
+
+✅ **Real-time Updates** — Status refreshes automatically at your chosen interval
+
+✅ **Non-intrusive** — Displays without interrupting your workflow
+
+✅ **Customizable** — Set monitoring frequency that works for you
+
+✅ **Manual Control** — Check status anytime with `/statusline:status`
+
+✅ **Plugin Integration** — Works seamlessly with other Claude Code plugins
+
+✅ **Token Awareness** — Shows actual token counts from Claude Code
+
+## Use Cases
+
+- **Monitor Context** — Know when you're approaching context limits before running out
+- **Track Progress** — See how many tasks have been completed in your session
+- **Debug Workflows** — Understand tool and agent activity during complex operations
+- **Optimize Sessions** — Identify bottlenecks and adjust your approach
+- **Stay Informed** — Keep awareness of background operations
+
+## How It Works
+
+The plugin reads session data from Claude Code's internal state and displays aggregated metrics about:
+
+1. **Token Usage** — Real counts from Claude Code's context window
+2. **Tool Activity** — Tracked from tool invocations in your session
+3. **Agent Operations** — Monitored from subagent execution
+4. **Task Management** — Read from your TodoWrite operations
+
+Updates happen at a regular interval (default 5 seconds) without blocking your work.
+
+## Requirements
+
+- Claude Code v1.0.80+
+- Node.js 18+ or Bun (if running custom build)
+
+## Inspiration
+
+This plugin is inspired by [claude-hud](https://github.com/jarrodwatts/claude-hud) but optimized for the claude-plugins marketplace with enhanced integration and customization options.
+
+## Development
+
+Session Monitor is built with:
+- TypeScript for type safety
+- Claude Code's native APIs
+- Minimal dependencies for quick performance
+
+### Source Structure
+
+```
+session-monitor/
+├── .claude-plugin/
+│   └── plugin.json         # Plugin manifest
+├── commands/
+│   ├── status.md          # Status command documentation
+│   ├── enable.md          # Enable command documentation
+│   └── disable.md         # Disable command documentation
+└── README.md              # This file
+```
+
+## Contributing
+
+Found an issue or have a feature idea? Contributions are welcome! This plugin is part of the [claude-plugins](https://github.com/duyet/claude-plugins) marketplace.
+
+## License
+
+MIT License — see LICENSE file
+
+## Related Plugins
+
+- **[team-agents](../team-agents)** — Coordinated parallel task execution
+- **[commit](../commit)** — Semantic Git commit automation
+- **[ralph-wiggum](../ralph-wiggum)** — Self-referential development loops
+
+---
+
+**Questions?** Open an issue on the [claude-plugins repository](https://github.com/duyet/claude-plugins/issues)

statusline/commands/config.md

@@ -0,0 +1,101 @@
+# /statusline:config
+
+Configure the statusline plugin with your preferences through interactive questions.
+
+## Usage
+
+```
+/statusline:config
+```
+
+## What It Does
+
+This command walks you through a series of questions to configure how statusline displays information in your Claude Code session:
+
+- **Display Frequency** — How often to update metrics (1-60 seconds)
+- **Display Format** — Compact, standard, or detailed output
+- **Metrics to Show** — Choose which metrics are important to you
+- **Color Theme** — Terminal-aware theme selection
+- **Auto-Start** — Enable monitoring automatically on session start
+
+## Configuration Questions
+
+The interactive setup includes:
+
+1. **Update Interval** — How frequently should statusline refresh?
+   - Fast (1-3 seconds) for active monitoring
+   - Standard (5-10 seconds) for balanced view
+   - Slow (15-60 seconds) for minimal updates
+
+2. **Display Mode** — How should metrics be displayed?
+   - **Compact** — Single line summary
+   - **Standard** — Multi-line detailed view (default)
+   - **Detailed** — Full breakdown with charts
+
+3. **Show Metrics** — Which information matters most?
+   - Context health
+   - Active tools
+   - Running agents
+   - Task progress
+   - Session duration
+
+4. **Color Theme** — Terminal color preference?
+   - Auto (detects terminal)
+   - Dark background
+   - Light background
+   - No colors (plain text)
+
+5. **Auto-Start** — Enable monitoring on session start?
+   - Enabled (recommended)
+   - Disabled
+
+## Example Session
+
+```
+$ /statusline:config
+
+⚙️  Statusline Configuration Wizard
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Q1: Update Interval?
+  ▶ Standard (5-10 seconds)
+  ○ Fast (1-3 seconds)
+  ○ Slow (15-60 seconds)
+
+Q2: Display Mode?
+  ○ Compact (single line)
+  ▶ Standard (multi-line)
+  ○ Detailed (with charts)
+
+Q3: Show metrics (select multiple)?
+  ☑ Context health
+  ☑ Active tools
+  ☑ Running agents
+  ☑ Task progress
+  ☑ Duration
+
+Q4: Color theme?
+  ▶ Auto (auto-detect)
+  ○ Dark
+  ○ Light
+  ○ None
+
+Q5: Auto-start monitoring?
+  ▶ Enabled
+  ○ Disabled
+
+✓ Configuration saved!
+→ Statusline will update every 5 seconds in standard mode
+→ Monitoring enabled on session start
+→ Use /statusline:status to view metrics anytime
+```
+
+## Configuration File
+
+Your settings are saved to `.statusline.config.json` in your project root. You can also manually edit this file if needed.
+
+## Related Commands
+
+- `/statusline:status` — View current metrics immediately
+- `/statusline:enable [interval]` — Enable with custom interval
+- `/statusline:disable` — Pause monitoring

statusline/commands/disable.md

@@ -0,0 +1,30 @@
+# /statusline:disable
+
+Disable real-time session monitoring and status updates.
+
+## Usage
+
+```
+/statusline:disable
+```
+
+## What It Does
+
+Stops background session monitoring while keeping the plugin active. This prevents periodic status updates from appearing in your session.
+
+- Stops real-time monitoring
+- Plugin remains installed and available
+- Status info can still be viewed on-demand with `/statusline:status`
+- Monitoring can be re-enabled anytime with `/statusline:enable`
+
+## Notes
+
+- Disabling only pauses automatic updates, not the plugin itself
+- You can still manually check session status with `/statusline:status`
+- Plugin data and history are preserved when disabled
+- No changes to your workflow or active tasks
+
+## Related Commands
+
+- `/statusline:enable` — Resume real-time monitoring
+- `/statusline:status` — View metrics without continuous monitoring

statusline/commands/enable.md

@@ -0,0 +1,48 @@
+# /statusline:enable
+
+Enable real-time session monitoring with automatic status updates.
+
+## Usage
+
+```
+/statusline:enable [interval]
+```
+
+### Parameters
+
+- `interval` (optional) — Update interval in seconds. Default: 5 seconds. Min: 1, Max: 60
+
+## What It Does
+
+Enables continuous monitoring of your session with status updates displayed at regular intervals:
+
+- Real-time context usage tracking
+- Active tool monitoring
+- Running agent visibility
+- Task/todo progress updates
+
+The monitor runs in the background and displays summary updates without interrupting your workflow.
+
+## Examples
+
+Enable with default 5-second updates:
+```
+/statusline:enable
+```
+
+Enable with custom 10-second interval:
+```
+/statusline:enable 10
+```
+
+## Notes
+
+- Monitoring is active by default when the plugin is installed
+- Updates respect your Claude Code terminal settings
+- You can view the current status anytime with `/statusline:status`
+- Use `/statusline:disable` to stop background updates
+
+## Related Commands
+
+- `/statusline:status` — View current metrics immediately
+- `/statusline:disable` — Stop background monitoring