feat(statusline): fix context display and add configurable formats

- Fix context showing 0% when data available (fallback to total_input_tokens)
- Hide empty values (Tools: None, Agents: None, Tasks: No tasks)
- Add configurable 1/2/3 line formats via ~/.claude/statusline.config.json
- Cache API usage data for 60s to avoid repeated API calls
- Format tokens as "111k" instead of "111,223"
- Use lowercase "ctx:" instead of "Context:"
- Format model as "opus-4.5" instead of "Opus 4 5"
- Rename /statusline:enable to /statusline:setup (interactive wizard)
- Add test suite at scripts/test-statusline.sh
- Add CLAUDE.md with dev notes and testing commands

🤖 Generated with [Claude Code](https://claude.com/claude-code)

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

Author: duyet

statusline/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "statusline",
-  "version": "1.2.0",
-  "description": "Real-time visibility into Claude Code sessions showing context usage, active tools, and task progress in compact one-line format",
+  "version": "1.4.0",
+  "description": "Configurable status bar showing context usage, API rate limits (5h/7d), git branch, and active tools. Supports 1/2/3 line layouts with smart hiding of empty values.",
   "author": {
     "name": "duyet"
   }

statusline/CLAUDE.md

@@ -0,0 +1,113 @@
+# Statusline Plugin Development Notes
+
+> **IMPORTANT**: Keep this file updated when modifying the statusline script or commands!
+
+## Architecture
+
+The statusline has two components:
+1. **Plugin commands** (`commands/*.md`) - Claude Code plugin commands
+2. **Shell script** (`~/.claude/statusline-command.sh`) - The actual renderer called by Claude Code
+
+The shell script is configured in `~/.claude/settings.json`:
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "/Users/duet/.claude/statusline-command.sh"
+  }
+}
+```
+
+## Data Sources
+
+The script gets data from two sources:
+
+1. **Stdin (real-time)** - Claude Code pipes JSON on every render:
+   - `context_window.total_input_tokens` - cumulative tokens
+   - `context_window.current_usage.*` - current context usage
+   - `model.id` - model name (e.g., "claude-opus-4-5-20251101")
+   - `workspace.current_dir` - working directory
+   - `version` - Claude Code version
+
+2. **API fetch (cached)** - Fetches from Anthropic OAuth API:
+   - 5-hour usage percentage
+   - 7-day usage percentage
+   - Reset timer
+   - **Cached for 60 seconds** (configurable via `USAGE_CACHE_TTL`)
+
+## Configuration
+
+Config file: `~/.claude/statusline.config.json`
+
+```json
+{
+  "line_format": "1" | "2" | "3",
+  "show_context": true,
+  "show_rate_limits": true,
+  "show_git_branch": true,
+  "show_tools": true,
+  "color_style": "colorful" | "minimal" | "plain"
+}
+```
+
+## Testing
+
+Run the test suite:
+```bash
+bash statusline/scripts/test-statusline.sh
+```
+
+### Manual Testing
+
+```bash
+# With full context data
+DEBUG_STATUSLINE=1 echo '{"workspace":{"current_dir":"/test"},"model":{"id":"claude-opus-4-5-20251101"},"version":"2.0.76","context_window":{"total_input_tokens":43000,"context_window_size":200000}}' | ~/.claude/statusline-command.sh
+
+# Test null current_usage (should fallback to total_input_tokens)
+echo '{"context_window":{"total_input_tokens":43000,"context_window_size":200000,"current_usage":null}}' | ~/.claude/statusline-command.sh
+
+# Test no context data (should hide context line)
+echo '{"context_window":{"total_input_tokens":0,"context_window_size":200000}}' | ~/.claude/statusline-command.sh
+
+# Test line formats
+echo '{"line_format":"1"}' > ~/.claude/statusline.config.json
+echo '{"context_window":{"total_input_tokens":43000,"context_window_size":200000}}' | ~/.claude/statusline-command.sh
+
+echo '{"line_format":"2"}' > ~/.claude/statusline.config.json
+echo '{"context_window":{"total_input_tokens":43000,"context_window_size":200000}}' | ~/.claude/statusline-command.sh
+
+echo '{"line_format":"3"}' > ~/.claude/statusline.config.json
+echo '{"context_window":{"total_input_tokens":43000,"context_window_size":200000}}' | ~/.claude/statusline-command.sh
+```
+
+## Environment Variables
+
+- `DEBUG_STATUSLINE=1` - Show diagnostic output to stderr
+- `SKIP_RATE_LIMITS=1` - Skip API fetch (for testing)
+- `USAGE_CACHE_TTL=60` - Cache TTL in seconds (default: 60)
+
+## Key Behaviors
+
+1. **Context fallback**: If `current_usage` is null or all zeros, uses `total_input_tokens`
+2. **Hide empty values**: Doesn't show "Context: 0%", "Tools: None", "Agents: None", "Tasks: No tasks"
+3. **Line format**: Configurable 1/2/3 line display via config file
+4. **API caching**: Usage data cached for 60s to avoid repeated API calls
+5. **Model formatting**: "claude-opus-4-5-20251101" → "opus-4.5"
+
+## Cache Files
+
+- `~/.claude/statusline.config.json` - User configuration
+- `~/.claude/statusline-usage-cache.json` - Cached API usage data (auto-generated)
+
+## Commands
+
+- `/statusline:setup` - Interactive setup wizard
+- `/statusline:status` - Show current metrics
+- `/statusline:config` - Quick format change
+- `/statusline:disable` - Disable statusline
+
+## Known Issues
+
+- Rate limit API requires proper OAuth scope; may show "re-login needed" if token lacks permission
+- `current_usage` may be null on first message of session (falls back to total_input_tokens)
+- macOS uses `stat -f %m`, Linux uses `stat -c %Y` for cache age check

statusline/commands/config.md

@@ -1,102 +1,67 @@
 # /statusline:config
 
-Configure the statusline plugin with your preferences through interactive questions.
+Configure the statusline display format.
 
-## Usage
+## Action Required
 
-```
-/statusline:config
-```
+When this command is invoked, you MUST use the AskUserQuestion tool to ask:
 
-## What It Does
+### Question: Line Format
 
-This command walks you through a series of questions to configure how statusline displays information in your Claude Code session:
+Ask the user which display format they prefer:
 
-- **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
+**Header**: "Lines"
+**Question**: "How many lines should the statusline display?"
 
-## Configuration Questions
+**Options**:
+1. **1 line (Compact)** — `dir (branch) │ Model │ Ctx% │ 5h/7d │ Tasks`
+2. **2 lines** — Line 1: location/model, Line 2: all metrics
+3. **3 lines (Default)** — Full layout with separate lines for location, metrics, and activity
 
-The interactive setup includes:
+### Save Configuration
 
-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
+After the user answers, save their choice to `~/.claude/statusline.config.json`:
 
-2. **Display Mode** — How should metrics be displayed?
-   - **Compact** — Single line summary (default)
-   - **Standard** — Multi-line detailed view
-   - **Detailed** — Full breakdown with charts
+```json
+{
+  "line_format": "1"
+}
+```
 
-3. **Show Metrics** — Which information matters most?
-   - Context health
-   - Active tools
-   - Running agents
-   - Task progress
-   - Session duration
+Use values: `"1"`, `"2"`, or `"3"`
 
-4. **Color Theme** — Terminal color preference?
-   - Auto (detects terminal)
-   - Dark background
-   - Light background
-   - No colors (plain text)
+### Confirm
+
+Output:
+```
+✓ Statusline configured: [N]-line format
+  Config saved to ~/.claude/statusline.config.json
+```
 
-5. **Auto-Start** — Enable monitoring on session start?
-   - Enabled (recommended)
-   - Disabled
+## Example Outputs
 
-## Example Session
+**1-line format**:
+```
+claude-plugins (master) │ Opus 4 5 │ Ctx: 21% │ 5h: 14% 7d: 46%
+```
 
+**2-line format**:
 ```
-$ /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 compact mode
-→ Monitoring enabled on session start
-→ Use /statusline:status to view metrics anytime
-→ Empty values automatically hidden (no "None", no empty lists)
+claude-plugins (master) │ Opus 4 5 │ v2.0.76
+Ctx: 21% │ 5h: 14% 7d: 46% │ Tasks: 2/5
 ```
 
-## Configuration File
+**3-line format** (default):
+```
+claude-plugins (master) │ Opus 4 5 │ v2.0.76
+Context: 21% (43,000 tokens) │ 5h: 14% 7d: 46%
+Tools: Sequential │ Tasks: 2/5
+```
 
-Your settings are saved to `.statusline.config.json` in your project root. You can also manually edit this file if needed.
+**Note**: Empty values are automatically hidden (no "None", no "0%", no "No tasks").
 
 ## Related Commands
 
-- `/statusline:status` — View current metrics immediately
-- `/statusline:enable [interval]` — Enable with custom interval
-- `/statusline:disable` — Pause monitoring
+- `/statusline:status` — View current metrics
+- `/statusline:enable` — Enable monitoring
+- `/statusline:disable` — Disable monitoring