feat(statusline): add JSON rate_limits parsing and enhanced setup interview

Parse rate_limits directly from Claude Code's stdin JSON input, avoiding
separate API calls when data is available. Add priority cascade:
JSON input → file cache → API fetch. Update setup interview with
context style, separator, and section visibility options. Update config
command with sub-menu for targeted configuration changes.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: claude

statusline/commands/config.md

@@ -1,89 +1,97 @@
 # /statusline:config
 
-Configure the statusline display format.
+Configure the statusline display format and preferences.
 
 ## Action Required
 
-When this command is invoked, you MUST use the AskUserQuestion tool to ask:
+When this command is invoked, ask the user what they want to change using AskUserQuestion:
 
-### Question: Line Format
+### Question: What to Configure
 
-Ask the user which display format they prefer:
+**Header**: "Config"
+**Question**: "What would you like to configure?"
+**Options**:
+1. **Layout** — Number of lines (1/2/3)
+2. **Sections** — Which info to show/hide
+3. **Context style** — How context usage is displayed
+4. **Reset to defaults**
 
-**Header**: "Lines"
-**Question**: "How many lines should the statusline display?"
+### If Layout selected:
 
+**Header**: "Layout"
+**Question**: "How many lines should the statusline display?"
 **Options**:
-1. **1 line (Compact)** — `dir (branch) │ Model │ Ctx% │ Rate │ Tasks`
+1. **1 line (Compact)** — `dir │ model │ ctx% │ rate │ tasks`
 2. **2 lines** — Line 1: location/model, Line 2: all metrics
-3. **3 lines (Default)** — Full layout with progress bar, token details, and activity
+3. **3 lines** — Full layout with progress bar, token details, activity
+
+### If Sections selected:
+
+**Header**: "Sections"
+**Question**: "Which sections should be visible?"
+**multiSelect**: true
+**Options**:
+1. **Context usage** — Token count and percentage
+2. **Rate limits** — API usage percentages and reset timers
+3. **Git branch** — Current branch name
+4. **Active tools** — Running MCP servers
+
+### If Context style selected:
+
+**Header**: "Context"
+**Question**: "How should context usage be displayed?"
+**Options**:
+1. **Compact** — `ctx: 21%`
+2. **With tokens** — `ctx: 21% 43k/200k`
+3. **Progress bar** — `██░░░░░░░░ 21% (43k/200k)`
 
 ### Save Configuration
 
-After the user answers, save their choice to `~/.claude/statusline.config.json`:
+Update `~/.claude/statusline.config.json` with the new values. Keep existing values for any settings not changed:
 
 ```json
 {
-  "line_format": "1"
+  "line_format": "2",
+  "show_context": true,
+  "show_rate_limits": true,
+  "show_git_branch": true,
+  "show_tools": true,
+  "context_style": "tokens",
+  "separator": "pipe"
 }
 ```
 
-Use values: `"1"`, `"2"`, or `"3"`
-
 ### Confirm
 
 Output:
 ```
-✓ Statusline configured: [N]-line format
+✓ Statusline updated: [setting changed]
   Config saved to ~/.claude/statusline.config.json
 ```
 
-## Example Outputs
-
-**Anthropic** (Claude, Opus, Sonnet):
+## Example Outputs by Provider
 
-1-line:
+**Anthropic** (2-line, tokens style):
 ```
-claude-plugins (master) │ Opus 4.5 │ ctx: 21% 43k/200k │ 5h: 42% 7d: 28%
+claude-plugins (master) │ claude-opus-4-5-20251101 │ v2.0.76
+ctx: 21% 43k/200k │ 5h: 42% │ 7d: 28% │ Tasks: 2/5
 ```
 
-2-line:
+**z.ai GLM** (2-line, tokens style):
 ```
-claude-plugins (master) │ Opus 4.5 │ v2.0.76
-ctx: 21% 43k/200k │ 5h: 42% │ 7d: 28% │ Tasks: 2/5 (40%)
+claude-plugins (master) │ glm-5.1 │ v2.0.76
+ctx: 21% 43k/200k │ tokens: 15% │ tools: 11% (883 left) Web:35 ZRead:82
 ```
 
-3-line:
+**Anthropic** (3-line, progress_bar style):
 ```
-claude-plugins (master) │ Opus 4.5 │ v2.0.76 │ explanatory
+claude-plugins (master) │ claude-opus-4-5-20251101 │ v2.0.76 │ explanatory
 ctx: ██░░░░░░░░ 21% (43k/200k tokens) │ 5h: 42% │ 7d: 28%
 Tools: Seq Ctx7 │ Agents: 2 active │ Tasks: 1/5 (20%)
 ```
 
-**z.ai GLM** (glm-5.1, glm-4, etc.):
-
-1-line:
-```
-claude-plugins (master) │ GLM 5.1 │ ctx: 21% 43k/200k │ tokens: 15% │ tools: 11% (883 left)
-```
-
-2-line:
-```
-claude-plugins (master) │ GLM 5.1 │ v2.0.76
-ctx: 21% 43k/200k │ tokens: 15% │ tools: 11% (883 left) Web:35 ZRead:82
-```
-
-3-line:
-```
-claude-plugins (master) │ GLM 5.1 │ v2.0.76 │ explanatory
-ctx: ██░░░░░░░░ 21% (43k/200k tokens) │ tokens: 15% │ tools: 11% (883 left) Web:35 ZRead:82
-Tools: Seq Ctx7 │ Agents: 1 active
-```
-
-**Note**: Empty values are automatically hidden (no "None", no "0%", no "No tasks").
-Provider is auto-detected from the model name.
-
 ## Related Commands
 
+- `/statusline:setup` — Full interactive setup wizard
 - `/statusline:status` — View current metrics
 - `/statusline:disable` — Disable monitoring

statusline/commands/setup.md

@@ -8,57 +8,65 @@ When this command is invoked, conduct an interview using AskUserQuestion, then g
 
 ### Interview Questions
 
-Use AskUserQuestion to ask these questions (can ask multiple in one call):
+Use AskUserQuestion to ask these questions (up to 4 at a time):
 
 #### Q1: Line Format
-**Header**: "Lines"
+**Header**: "Layout"
 **Question**: "How many lines should the statusline display?"
 **Options**:
 1. **1 line (Compact)** — Everything on one line
 2. **2 lines** — Location/model + metrics (Recommended)
-3. **3 lines** — Full layout with separate sections
+3. **3 lines** — Full layout with progress bar and token details
 
-#### Q2: Information to Show
+#### Q2: Information Sections
 **Header**: "Show"
 **Question**: "What information do you want to see?"
 **multiSelect**: true
 **Options**:
-1. **Context usage** — Token count and percentage
-2. **Rate limits** — 5-hour and 7-day API usage
+1. **Context usage** — Token count, percentage, progress bar
+2. **Rate limits** — API usage (5h/7d for Anthropic, tokens/tools for GLM)
 3. **Git branch** — Current branch name
-4. **Active tools** — Running MCP servers/tools
+4. **Active tools** — Running MCP servers and tool counts
 
-#### Q3: Color Style
-**Header**: "Colors"
-**Question**: "What color style do you prefer?"
+#### Q3: Context Display Style
+**Header**: "Context"
+**Question**: "How should context usage be displayed?"
 **Options**:
-1. **Colorful** — Full color with health indicators (Recommended)
-2. **Minimal** — Muted colors, less visual noise
-3. **Plain** — No colors (for simple terminals)
+1. **Compact** — Just percentage: `ctx: 21%`
+2. **With tokens** — Percentage + token counts: `ctx: 21% 43k/200k`
+3. **Progress bar** — Visual bar + details: `██░░ 21% (43k/200k)`
 
-### Generate Statusline Script
+#### Q4: Separator Style
+**Header**: "Separator"
+**Question**: "What separator style between sections?"
+**Options**:
+1. **Pipe** — `│` vertical bar (Recommended)
+2. **Slash** — `/` forward slash
+3. **Dot** — `·` middle dot
+4. **Arrow** — `→` arrow
 
-Based on answers, generate `~/.claude/statusline-command.sh` with the user's preferences:
+### Generate Statusline Script
 
-1. Read the current script at `~/.claude/statusline-command.sh`
-2. Modify the configuration section based on answers:
-   - Set `line_format` based on Q1
-   - Enable/disable sections based on Q2
-   - Set color intensity based on Q3
-3. Save the updated script
+Based on answers, update `~/.claude/statusline.config.json`:
 
-Also save config to `~/.claude/statusline.config.json`:
 ```json
 {
   "line_format": "2",
   "show_context": true,
   "show_rate_limits": true,
   "show_git_branch": true,
   "show_tools": true,
+  "show_agents": true,
+  "show_tasks": true,
+  "context_style": "compact",
+  "separator": "pipe",
   "color_style": "colorful"
 }
 ```
 
+**Context style values**: `"compact"`, `"tokens"`, `"progress_bar"`
+**Separator values**: `"pipe"`, `"slash"`, `"dot"`, `"arrow"`
+
 ### Configure Claude Code Settings
 
 Ensure `~/.claude/settings.json` has the statusLine configuration:
@@ -73,9 +81,9 @@ Ensure `~/.claude/settings.json` has the statusLine configuration:
 
 ### Show Preview
 
-After setup, show a preview of the statusline output by running:
+After setup, show a preview by running:
 ```bash
-echo '{"workspace":{"current_dir":"'$(pwd)'"},"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
+echo '{"workspace":{"current_dir":"'$(pwd)'"},"model":{"id":"claude-opus-4-5-20251101"},"version":"2.0.76","context_window":{"total_input_tokens":43000,"context_window_size":200000,"current_usage":{"input_tokens":35000,"cache_creation_input_tokens":5000,"cache_read_input_tokens":3000}},"rate_limits":{"five_hour":{"used_percentage":45},"seven_day":{"used_percentage":28}}}' | ~/.claude/statusline-command.sh
 ```
 
 ### Confirm Setup
@@ -85,40 +93,20 @@ Output:
 ✓ Statusline configured successfully!
 
 Your settings:
-  • Format: [N]-line layout
+  • Layout: 2-line
   • Showing: Context, Rate limits, Git branch, Tools
-  • Colors: Colorful
+  • Context style: With tokens
+  • Separator: Pipe (│)
 
 Preview:
 [show the actual statusline output]
 
 The statusline will update automatically during your session.
-Use /statusline:config to change settings anytime.
-```
-
-## Example Interview Flow
-
-```
-Q1: How many lines should the statusline display?
-   → User selects: 2 lines
-
-Q2: What information do you want to see?
-   → User selects: Context usage, Rate limits, Git branch
-
-Q3: What color style do you prefer?
-   → User selects: Colorful
-
-✓ Generating your statusline...
-✓ Config saved to ~/.claude/statusline.config.json
-✓ Script updated at ~/.claude/statusline-command.sh
-
-Preview:
-claude-plugins (master) │ Opus 4 5 │ v2.0.76
-Context: 21% (43,000 tokens) │ 5h: 14% 7d: 46%
+Use /statusline:config to change layout anytime.
 ```
 
 ## Related Commands
 
 - `/statusline:status` — View current metrics
-- `/statusline:config` — Quick config change (just line format)
+- `/statusline:config` — Quick layout change
 - `/statusline:disable` — Disable statusline