@owloops/claude-powerline 1.22.1 → 1.23.1

package/README.md

@@ -107,11 +107,24 @@ Lightweight and fast with no external dependencies to install.
 
 ## Installation
 
-### Setup
-
 Requires Node.js 18+, Claude Code, and Git 2.0+. For best display, install a [Nerd Font](https://www.nerdfonts.com/) or use `--charset=text` for ASCII-only symbols.
 
-**1. Add to your Claude Code `settings.json`:**
+### Setup Wizard (Recommended)
+
+The interactive wizard walks you through theme, style, font, segment, and budget selection.
+
+```bash
+# run inside Claude Code (pick one install method)
+/plugin marketplace add Owloops/claude-powerline   # from GitHub
+/plugin install @owloops/claude-powerline@claude-powerline   # or from npm
+/powerline
+```
+
+The wizard writes `~/.claude/claude-powerline.json` and updates your `settings.json` automatically. Run `/powerline` again any time to reconfigure.
+
+### Manual Setup
+
+Add to your Claude Code `settings.json`:
 
 ```json
 {
@@ -122,15 +135,42 @@ Requires Node.js 18+, Claude Code, and Git 2.0+. For best display, install a [Ne
 }
 ```
 
-**2. Start a Claude session** - the statusline appears at the bottom during conversations.
+Start a Claude session and the statusline appears at the bottom.
 
 ![Claude Code with powerline](images/claude-interface-with-powerline.png)
 
 Using `npx` automatically downloads and runs the latest version without manual updates.
 
-## Usage
+## Styles
+
+<img src="images/claude-powerline-styles.png" alt="Claude Powerline Styles" width="600">
+
+- **minimal** -- Segments separated by spaces, no decorations
+- **powerline** -- Arrow-shaped separators between segments (best with Nerd Font)
+- **capsule** -- Rounded pill-shaped segments (best with Nerd Font)
+- **tui** -- Bordered panel with responsive multi-line layout. TUI mode is **opinionated**: it always displays all data regardless of segment configuration. Only theme, charset, and budget thresholds are respected.
+
+<details>
+<summary><h2>Configuration</h2></summary>
+
+**Config locations** (in priority order):
+
+- `./.claude-powerline.json` - Project-specific
+- `~/.claude/claude-powerline.json` - User config
+- `~/.config/claude-powerline/config.json` - XDG standard
+
+**Override priority:** CLI flags > Environment variables > Config files > Defaults
+
+Config files reload automatically, no restart needed.
+
+**Get example config:**
+
+```bash
+curl -o ~/.claude/claude-powerline.json https://raw.githubusercontent.com/Owloops/claude-powerline/main/.claude-powerline.json
+```
 
-Once added to Claude Code settings, the statusline runs automatically. For customization:
+<details>
+<summary><strong>CLI Options and Environment Variables</strong></summary>
 
 **CLI Options** (both `--arg value` and `--arg=value` syntax supported):
 
@@ -157,49 +197,7 @@ export CLAUDE_POWERLINE_CONFIG=/path/to/config.json
 export CLAUDE_POWERLINE_DEBUG=1  # Enable debug logging
 ```
 
-## Styles
-
-<img src="images/claude-powerline-styles.png" alt="Claude Powerline Styles" width="600">
-
-### TUI Panel Mode
-
-The `tui` style renders a bordered panel with all available data in a responsive layout. Unlike other styles, TUI mode is **opinionated**: it always displays all data regardless of segment enable/disable configuration. Only theme, charset, and budget thresholds are respected.
-
-```json
-{
-  "statusLine": {
-    "type": "command",
-    "command": "npx -y @owloops/claude-powerline@latest --style=tui"
-  }
-}
-```
-
-The panel adapts to terminal width across three breakpoints:
-- **Wide** (80+ cols): metrics on one line, workspace and footer spread across columns
-- **Medium** (55-79 cols): metrics split across two lines, stacked footer
-- **Narrow** (<55 cols): fully stacked layout
-
-> [!NOTE]
-> Claude Code's internal progress indicators (spinner, context bar) may briefly overlap the TUI panel during tool calls. This is a limitation of the hook architecture and resolves once the tool call completes.
-
-## Configuration
-
-**Get example config:**
-
-```bash
-# Download full-featured example config
-curl -o ~/.claude/claude-powerline.json https://raw.githubusercontent.com/Owloops/claude-powerline/main/.claude-powerline.json
-```
-
-**Config locations** (in priority order):
-
-- `./.claude-powerline.json` - Project-specific
-- `~/.claude/claude-powerline.json` - User config
-- `~/.config/claude-powerline/config.json` - XDG standard
-
-**Override priority:** CLI flags → Environment variables → Config files → Defaults
-
-Config files reload automatically and no restart needed.
+</details>
 
 ### Segment Configuration
 
@@ -252,52 +250,59 @@ Config files reload automatically and no restart needed.
 
 **Symbols:**
 
-- Unicode: `⎇` Branch • `♯` SHA • `⌂` Tag • `⧇` Stash • `✓` Clean • `●` Dirty • `⚠` Conflicts • `↑3` Ahead • `↓2` Behind • `(+1 ~2 ?3)` Staged/Unstaged/Untracked
-- Text: `~` Branch • `#` SHA • `T` Tag • `S` Stash • `=` Clean • `*` Dirty • `!` Conflicts • `^3` Ahead • `v2` Behind • `(+1 ~2 ?3)` Staged/Unstaged/Untracked
+- Unicode: `⎇` Branch &#8226; `♯` SHA &#8226; `⌂` Tag &#8226; `⧇` Stash &#8226; `✓` Clean &#8226; `●` Dirty &#8226; `⚠` Conflicts &#8226; `↑3` Ahead &#8226; `↓2` Behind &#8226; `(+1 ~2 ?3)` Staged/Unstaged/Untracked
+- Text: `~` Branch &#8226; `#` SHA &#8226; `T` Tag &#8226; `S` Stash &#8226; `=` Clean &#8226; `*` Dirty &#8226; `!` Conflicts &#8226; `^3` Ahead &#8226; `v2` Behind &#8226; `(+1 ~2 ?3)` Staged/Unstaged/Untracked
 
 </details>
 
 <details>
-<summary><strong>Metrics</strong> - Shows performance analytics from your Claude sessions</summary>
+<summary><strong>Model</strong> - Shows current Claude model being used</summary>
 
 ```json
-"metrics": {
+"model": {
+  "enabled": true
+}
+```
+
+**Symbols:** `✱` Model (unicode) &#8226; `M` Model (text)
+
+</details>
+
+<details>
+<summary><strong>Session</strong> - Shows real-time usage for current Claude conversation</summary>
+
+```json
+"session": {
   "enabled": true,
-  "showResponseTime": true,
-  "showLastResponseTime": false,
-  "showDuration": true,
-  "showMessageCount": true,
-  "showLinesAdded": true,
-  "showLinesRemoved": true
+  "type": "tokens",
+  "costSource": "calculated"
 }
 ```
 
 **Options:**
 
-- `showResponseTime`: Total API duration across all requests
-- `showLastResponseTime`: Individual response time for most recent query
-- `showDuration`: Total session duration
-- `showMessageCount`: Number of user messages sent
-- `showLinesAdded`: Lines of code added during session
-- `showLinesRemoved`: Lines of code removed during session
-
-**Symbols:**
+- `type`: Display format - `cost` | `tokens` | `both` | `breakdown`
+- `costSource`: Cost calculation method - `calculated` (ccusage-style) | `official` (hook data)
 
-- Unicode: `⧖` Total API time • `Δ` Last response • `⧗` Session duration • `⟐` Messages • `+` Lines added • `-` Lines removed
-- Text: `R` Total API time • `L` Last response • `T` Session duration • `#` Messages • `+` Lines added • `-` Lines removed
+**Symbols:** `§` Session (unicode) &#8226; `S` Session (text)
 
 </details>
 
 <details>
-<summary><strong>Model</strong> - Shows current Claude model being used</summary>
+<summary><strong>Today</strong> - Shows total daily usage with budget monitoring</summary>
 
 ```json
-"model": {
-  "enabled": true
+"today": {
+  "enabled": true,
+  "type": "cost"
 }
 ```
 
-**Symbols:** `✱` Model (unicode) • `M` Model (text)
+**Options:**
+
+- `type`: Display format - `cost` | `tokens` | `both` | `breakdown`
+
+**Symbols:** `☉` Today (unicode) &#8226; `D` Today (text)
 
 </details>
 
@@ -324,7 +329,7 @@ Config files reload automatically and no restart needed.
 
 | Style | Filled | Empty | Example |
 |-------|--------|-------|---------|
-| `text` | — | — | `◔ 34,040 (79%)` |
+| `text` | -- | -- | `◔ 34,040 (79%)` |
 | `ball` | ─ | ─ | `─────●──── 50%` |
 | `bar` | ▓ | ░ | `▓▓▓▓▓░░░░░ 50%` |
 | `blocks` | █ | ░ | `█████░░░░░ 50%` |
@@ -336,9 +341,9 @@ Config files reload automatically and no restart needed.
 | `line` | ━ | ┄ | `━━━━━┄┄┄┄┄ 50%` |
 | `squares` | ◼ | ◻ | `◼◼◼◼◼◻◻◻◻◻ 50%` |
 
-**Symbols:** `◔` Context (unicode) • `C` Context (text)
+**Symbols:** `◔` Context (unicode) &#8226; `C` Context (text)
 
-##### Model Context Limits
+#### Model Context Limits
 
 Configure context window limits for different model types. Defaults to 200K tokens for all models.
 
@@ -359,74 +364,6 @@ Configure context window limits for different model types. Defaults to 200K toke
 
 </details>
 
-<details>
-<summary><strong>Tmux</strong> - Shows tmux session name and window info when in tmux</summary>
-
-```json
-"tmux": {
-  "enabled": true
-}
-```
-
-**Display:** `tmux:session-name`
-
-</details>
-
-<details>
-<summary><strong>Session ID</strong> - Shows the current Claude session identifier</summary>
-
-```json
-"sessionId": {
-  "enabled": false,
-  "showIdLabel": true
-}
-```
-
-**Options:**
-
-- `showIdLabel`: Show the `⌗` icon prefix before the session ID (default: `true`)
-
-**Display:** `⌗ a1b2c3d4-...`
-
-**Symbols:** `⌗` Session ID (unicode) • `#` Session ID (text)
-
-</details>
-
-<details>
-<summary><strong>Version</strong> - Shows Claude Code version</summary>
-
-```json
-"version": {
-  "enabled": true
-}
-```
-
-**Display:** `v1.0.81`
-
-**Symbols:** `◈` Version (unicode) • `V` Version (text)
-
-</details>
-
-<details>
-<summary><strong>Session</strong> - Shows real-time usage for current Claude conversation</summary>
-
-```json
-"session": {
-  "enabled": true,
-  "type": "tokens",
-  "costSource": "calculated"
-}
-```
-
-**Options:**
-
-- `type`: Display format - `cost` | `tokens` | `both` | `breakdown`
-- `costSource`: Cost calculation method - `calculated` (ccusage-style) | `official` (hook data)
-
-**Symbols:** `§` Session (unicode) • `S` Session (text)
-
-</details>
-
 <details>
 <summary><strong>Block</strong> - Shows usage within current 5-hour billing window (Claude's rate limit period)</summary>
 
@@ -465,7 +402,7 @@ Configure context window limits for different model types. Defaults to 200K toke
 
 **Weighted Tokens:** In transcript mode, Opus tokens count 5x toward rate limits compared to Sonnet/Haiku tokens
 
-**Symbols:** `◱` Block (unicode) • `B` Block (text)
+**Symbols:** `◱` Block (unicode) &#8226; `B` Block (text)
 
 </details>
 
@@ -485,25 +422,86 @@ Configure context window limits for different model types. Defaults to 200K toke
 
 Only visible when Claude Code provides native `rate_limits.seven_day` data (Claude.ai Pro/Max subscribers). Hidden when the data is not available.
 
-**Symbols:** `◑` Weekly (unicode) • `W` Weekly (text)
+**Symbols:** `◑` Weekly (unicode) &#8226; `W` Weekly (text)
 
 </details>
 
 <details>
-<summary><strong>Today</strong> - Shows total daily usage with budget monitoring</summary>
+<summary><strong>Metrics</strong> - Shows performance analytics from your Claude sessions</summary>
 
 ```json
-"today": {
+"metrics": {
   "enabled": true,
-  "type": "cost"
+  "showResponseTime": true,
+  "showLastResponseTime": false,
+  "showDuration": true,
+  "showMessageCount": true,
+  "showLinesAdded": true,
+  "showLinesRemoved": true
 }
 ```
 
 **Options:**
 
-- `type`: Display format - `cost` | `tokens` | `both` | `breakdown`
+- `showResponseTime`: Total API duration across all requests
+- `showLastResponseTime`: Individual response time for most recent query
+- `showDuration`: Total session duration
+- `showMessageCount`: Number of user messages sent
+- `showLinesAdded`: Lines of code added during session
+- `showLinesRemoved`: Lines of code removed during session
+
+**Symbols:**
+
+- Unicode: `⧖` Total API time &#8226; `Δ` Last response &#8226; `⧗` Session duration &#8226; `⟐` Messages &#8226; `+` Lines added &#8226; `-` Lines removed
+- Text: `R` Total API time &#8226; `L` Last response &#8226; `T` Session duration &#8226; `#` Messages &#8226; `+` Lines added &#8226; `-` Lines removed
+
+</details>
+
+<details>
+<summary><strong>Version</strong> - Shows Claude Code version</summary>
+
+```json
+"version": {
+  "enabled": true
+}
+```
 
-**Symbols:** `☉` Today (unicode) • `D` Today (text)
+**Display:** `v1.0.81`
+
+**Symbols:** `◈` Version (unicode) &#8226; `V` Version (text)
+
+</details>
+
+<details>
+<summary><strong>Tmux</strong> - Shows tmux session name and window info when in tmux</summary>
+
+```json
+"tmux": {
+  "enabled": true
+}
+```
+
+**Display:** `tmux:session-name`
+
+</details>
+
+<details>
+<summary><strong>Session ID</strong> - Shows the current Claude session identifier</summary>
+
+```json
+"sessionId": {
+  "enabled": false,
+  "showIdLabel": true
+}
+```
+
+**Options:**
+
+- `showIdLabel`: Show the `⌗` icon prefix before the session ID (default: `true`)
+
+**Display:** `⌗ a1b2c3d4-...`
+
+**Symbols:** `⌗` Session ID (unicode) &#8226; `#` Session ID (text)
 
 </details>
 
@@ -525,11 +523,14 @@ Only visible when Claude Code provides native `rate_limits.seven_day` data (Clau
 
 Hidden when the variable is unset or empty.
 
-**Symbols:** `⚙` Env (unicode) • `$` Env (text)
+**Symbols:** `⚙` Env (unicode) &#8226; `$` Env (text)
 
 </details>
 
-### Budget Configuration
+### Advanced Configuration
+
+<details>
+<summary><strong>Budget Configuration</strong></summary>
 
 ```json
 "budget": {
@@ -545,12 +546,15 @@ Hidden when the variable is unset or empty.
 - `type`: Budget type - `cost` (USD) | `tokens` (for token-based limits)
 - `warningThreshold`: Warning threshold percentage (default: 80)
 
-**Indicators:** `25%` Normal • `+75%` Moderate (50-79%) • `!85%` Warning (80%+)
+**Indicators:** `25%` Normal &#8226; `+75%` Moderate (50-79%) &#8226; `!85%` Warning (80%+)
 
 > [!TIP]
 > Claude's rate limits consider multiple factors beyond tokens (message count, length, attachments, model). See [Anthropic's usage documentation](https://support.anthropic.com/en/articles/11014257-about-claude-s-max-plan-usage) for details.
 
-### Character Sets
+</details>
+
+<details>
+<summary><strong>Character Sets</strong></summary>
 
 Choose between Unicode symbols (requires Nerd Font) or ASCII text mode for maximum compatibility.
 
@@ -564,27 +568,22 @@ Choose between Unicode symbols (requires Nerd Font) or ASCII text mode for maxim
 
 **Options:**
 
-- `unicode` (default) - Uses Nerd Font icons and symbols (⎇, ✱, ●, ↑, ↓, etc.)
-- `text` - ASCII-only characters (~, M, *, ^, v, etc.) for terminals without Nerd Font
-
-**Combinations with styles:**
+- `unicode` (default) - Uses Nerd Font icons and symbols
+- `text` - ASCII-only characters for terminals without Nerd Font
 
 The charset setting works independently from separator styles, giving you 8 possible combinations:
+
 - `minimal` + `unicode` / `text` - No separators
 - `powerline` + `unicode` / `text` - Arrow separators (requires Nerd Font for unicode)
 - `capsule` + `unicode` / `text` - Rounded caps (requires Nerd Font for unicode)
 - `tui` + `unicode` / `text` - Bordered panel with rounded or ASCII box characters
 
-**CLI Usage:**
-
-```bash
-claude-powerline --charset=text --style=minimal
-claude-powerline --charset=unicode --style=powerline
-```
+</details>
 
-### Auto-Wrap
+<details>
+<summary><strong>Layout: Auto-Wrap, Multi-line, and Padding</strong></summary>
 
-Automatically wrap segments to new lines based on terminal width.
+**Auto-Wrap** (enabled by default):
 
 ```json
 {
@@ -594,11 +593,9 @@ Automatically wrap segments to new lines based on terminal width.
 }
 ```
 
-Segments flow naturally and wrap to new lines when they exceed the terminal width. The layout adjusts automatically when the terminal is resized. Enabled by default.
+Segments flow naturally and wrap to new lines when they exceed the terminal width.
 
-### Multi-line Layout
-
-Alternatively, manually organize segments across multiple lines.
+**Multi-line Layout** for manual control:
 
 ```json
 {
@@ -623,12 +620,7 @@ Alternatively, manually organize segments across multiple lines.
 }
 ```
 
-> [!NOTE]
-> Claude Code system messages may truncate long status lines. Use `autoWrap` or manual multi-line layouts to prevent segment cutoff.
-
-### Padding
-
-Control the spacing inside each segment.
+**Padding** - number of spaces on each side of segment text:
 
 ```json
 {
@@ -638,9 +630,15 @@ Control the spacing inside each segment.
 }
 ```
 
-The value is the number of spaces on each side of the text. Set to `0` for a compact look, `1` (default) for standard spacing, or higher for more breathing room.
+Set to `0` for compact, `1` (default) for standard spacing.
 
-### Colors & Themes
+> [!NOTE]
+> Claude Code system messages may truncate long status lines. Use `autoWrap` or manual multi-line layouts to prevent segment cutoff.
+
+</details>
+
+<details>
+<summary><strong>Colors and Custom Themes</strong></summary>
 
 Create custom themes and configure color compatibility:
 
@@ -660,7 +658,7 @@ Create custom themes and configure color compatibility:
 }
 ```
 
-**Color Options:** `bg` (hex, `transparent`, `none`) • `fg` (hex)
+**Color Options:** `bg` (hex, `transparent`, `none`) &#8226; `fg` (hex)
 
 **Compatibility Modes:** `auto` (default), `ansi`, `ansi256`, `truecolor`
 
@@ -677,16 +675,39 @@ Create custom themes and configure color compatibility:
 
 **Priority:** `FORCE_COLOR` overrides `NO_COLOR` (allowing color to be forced on even when NO_COLOR is set)
 
-## Performance
+</details>
+
+<details>
+<summary><strong>TUI Panel Mode</strong></summary>
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "npx -y @owloops/claude-powerline@latest --style=tui"
+  }
+}
+```
+
+The panel adapts to terminal width across three breakpoints:
+
+- **Wide** (80+ cols): metrics on one line, workspace and footer spread across columns
+- **Medium** (55-79 cols): metrics split across two lines, stacked footer
+- **Narrow** (<55 cols): fully stacked layout
+
+> [!NOTE]
+> Claude Code's internal progress indicators (spinner, context bar) may briefly overlap the TUI panel during tool calls. This is a limitation of the hook architecture and resolves once the tool call completes.
+
+</details>
+
+<details>
+<summary><strong>Performance</strong></summary>
 
 Execution times for different configurations:
 
 - **~80ms** default config (`directory`, `git`, `model`, `session`, `today`, `context`)
 - **~240ms** full-featured (all segments enabled)
 
-<details>
-<summary><strong>Detailed Segment Timings</strong></summary>
-
 | Segment     | Timing | Notes                                      |
 | ----------- | ------ | ------------------------------------------ |
 | `directory` | ~40ms  | No external commands                       |
@@ -702,15 +723,16 @@ Execution times for different configurations:
 
 **Benchmark:** `npm run benchmark:timing`
 
-</details>
-
-### Optimization Tips
+**Optimization Tips:**
 
 - **Global install:** `npm install -g` to avoid npx overhead
 - **Disable unused segments** for faster execution
 - **Cache cleanup:** Remove `~/.claude/powerline/` if needed
 
-## Custom Segments
+</details>
+
+<details>
+<summary><strong>Custom Segments (Shell Composition)</strong></summary>
 
 Extend the statusline using shell composition:
 
@@ -724,9 +746,13 @@ Extend the statusline using shell composition:
 }
 ```
 
-> [!NOTE]  
+> [!NOTE]
 > Use `tput` for colors: `setab <bg>` (background), `setaf <fg>` (foreground), `sgr0` (reset). Example: `echo "$(tput setab 4)$(tput setaf 15) text $(tput sgr0)"`. For complex logic, create a shell script with multiple commands, conditions, and variables.
 
+</details>
+
+</details>
+
 ## Contributing
 
 Contributions are welcome! Please feel free to submit issues or pull requests.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owloops/claude-powerline",
-  "version": "1.22.1",
+  "version": "1.23.1",
   "description": "Beautiful vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, and custom themes",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -44,6 +44,7 @@
   "files": [
     "dist",
     "bin",
+    "plugin",
     "README.md",
     "LICENSE"
   ],

package/plugin/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "claude-powerline",
+  "version": "1.0.0",
+  "description": "Claude Powerline statusline setup wizard",
+  "author": {
+    "name": "Owloops"
+  },
+  "repository": "https://github.com/Owloops/claude-powerline",
+  "license": "MIT",
+  "keywords": ["powerline", "statusline", "claude-code", "setup"]
+}

package/plugin/bin/preview.sh

@@ -0,0 +1,199 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+readonly SCRIPT_DIR
+readonly PLUGIN_ROOT="${SCRIPT_DIR}/.."
+
+readonly SAMPLE_JSON='{"model":{"id":"claude-sonnet-4-20250514","display_name":"Sonnet 4"},"cost":{"total_cost_usd":0.42,"message_cost_usd":0.03,"duration":"15m"},"context_window":{"context_window_size":200000,"used_percentage":35,"current_usage":{"input_tokens":50000,"cache_creation_input_tokens":10000,"cache_read_input_tokens":5000}},"cwd":"/home/user/my-project","workspace":{"current_dir":"/home/user/my-project"},"session":{"session_id":"abc123"}}'
+
+readonly PREVIEW_CONFIG='{
+  "theme": "dark",
+  "display": {
+    "style": "minimal",
+    "charset": "unicode",
+    "colorCompatibility": "auto",
+    "autoWrap": true,
+    "padding": 1,
+    "lines": [
+      {
+        "segments": {
+          "directory": { "enabled": true, "style": "fish" },
+          "git": { "enabled": true },
+          "model": { "enabled": true },
+          "session": { "enabled": true, "type": "cost", "costSource": "calculated" },
+          "today": { "enabled": true, "type": "cost" },
+          "context": { "enabled": true, "showPercentageOnly": false, "displayStyle": "text", "autocompactBuffer": 33000 }
+        }
+      }
+    ]
+  },
+  "budget": {
+    "session": { "warningThreshold": 80 },
+    "today": { "amount": 50, "warningThreshold": 80 }
+  }
+}'
+
+THEME="dark"
+STYLE="minimal"
+CHARSET="unicode"
+COMPARE_STYLES=false
+COMPARE_THEMES=false
+BIN=""
+TEMP_FILES=()
+
+# shellcheck disable=SC2329
+cleanup() {
+    for f in "${TEMP_FILES[@]}"; do
+        rm -f "${f}"
+    done
+}
+trap cleanup EXIT
+
+find_binary() {
+    local npm_bin="${PLUGIN_ROOT}/../bin/claude-powerline"
+    if [[ -f "${npm_bin}" ]]; then
+        printf '%s' "${npm_bin}"
+        return 0
+    fi
+
+    if command -v claude-powerline >/dev/null 2>&1; then
+        command -v claude-powerline
+        return 0
+    fi
+
+    printf 'npx'
+    return 0
+}
+
+make_temp_config() {
+    local preview_theme="$1"
+    local preview_style="$2"
+    local preview_charset="$3"
+    local tmp
+
+    tmp="$(mktemp)"
+    TEMP_FILES+=("${tmp}")
+    printf '%s' "${PREVIEW_CONFIG}" |
+        sed -e "s/\"theme\": \"dark\"/\"theme\": \"${preview_theme}\"/" \
+            -e "s/\"style\": \"minimal\"/\"style\": \"${preview_style}\"/" \
+            -e "s/\"charset\": \"unicode\"/\"charset\": \"${preview_charset}\"/" \
+            >"${tmp}"
+    printf '%s' "${tmp}"
+}
+
+run_preview() {
+    local preview_theme="$1"
+    local preview_style="$2"
+    local preview_charset="$3"
+    local tmp_config
+
+    tmp_config="$(make_temp_config "${preview_theme}" "${preview_style}" "${preview_charset}")"
+
+    if [[ "${BIN}" == "npx" ]]; then
+        printf '%s' "${SAMPLE_JSON}" | npx -y @owloops/claude-powerline@latest \
+            --config="${tmp_config}"
+    else
+        printf '%s' "${SAMPLE_JSON}" | "${BIN}" \
+            --config="${tmp_config}"
+    fi
+}
+
+run_compare_styles() {
+    local styles=(minimal powerline capsule tui)
+    local s
+
+    for s in "${styles[@]}"; do
+        printf '%s:\n' "${s}"
+        run_preview "${THEME}" "${s}" "${CHARSET}"
+        printf '\n\n'
+    done
+}
+
+run_compare_themes() {
+    local themes=(dark light nord tokyo-night rose-pine gruvbox)
+    local t
+
+    for t in "${themes[@]}"; do
+        printf '%s:\n' "${t}"
+        run_preview "${t}" "${STYLE}" "${CHARSET}"
+        printf '\n\n'
+    done
+}
+
+parse_args() {
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --theme=*)
+                THEME="${1#*=}"
+                shift
+                ;;
+            --theme)
+                [[ $# -ge 2 ]] || {
+                    printf 'Missing value for --theme\n' >&2
+                    exit 1
+                }
+                THEME="$2"
+                shift 2
+                ;;
+            --style=*)
+                STYLE="${1#*=}"
+                shift
+                ;;
+            --style)
+                [[ $# -ge 2 ]] || {
+                    printf 'Missing value for --style\n' >&2
+                    exit 1
+                }
+                STYLE="$2"
+                shift 2
+                ;;
+            --charset=*)
+                CHARSET="${1#*=}"
+                shift
+                ;;
+            --charset)
+                [[ $# -ge 2 ]] || {
+                    printf 'Missing value for --charset\n' >&2
+                    exit 1
+                }
+                CHARSET="$2"
+                shift 2
+                ;;
+            --compare-styles)
+                COMPARE_STYLES=true
+                shift
+                ;;
+            --compare-themes)
+                COMPARE_THEMES=true
+                shift
+                ;;
+            *)
+                printf 'Unknown option: %s\n' "$1" >&2
+                exit 1
+                ;;
+        esac
+    done
+}
+
+main() {
+    parse_args "$@"
+    BIN="$(find_binary)"
+
+    if [[ "${COMPARE_STYLES}" == "true" ]]; then
+        run_compare_styles
+        exit 0
+    fi
+
+    if [[ "${COMPARE_THEMES}" == "true" ]]; then
+        run_compare_themes
+        exit 0
+    fi
+
+    run_preview "${THEME}" "${STYLE}" "${CHARSET}"
+    printf '\n'
+    exit 0
+}
+
+main "$@"

package/plugin/commands/powerline.md

@@ -0,0 +1,322 @@
+---
+name: powerline
+description: Claude Powerline statusline setup wizard
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Edit
+  - AskUserQuestion
+  - Glob
+---
+
+# Claude Powerline Setup Wizard
+
+You are running an interactive setup wizard to configure the claude-powerline statusline for Claude Code. Follow these steps in order, using AskUserQuestion for each decision point.
+
+## Important Notes
+
+- Do not skip steps or combine questions.
+- Always wait for the user's response before moving to the next step.
+- Track the user's choices in variables throughout the wizard.
+- The final config is written as JSON to `~/.claude/claude-powerline.json`.
+- Do NOT use the Agent tool or Explore subagents. All information you need is in this document.
+- Do NOT read source code from the claude-powerline package. Use only the instructions below.
+- IMPORTANT: After running any Bash or Read tool, repeat the key output as text in your response. Some users have a collapsed UI mode where tool outputs require a click to expand. Always relay important results (like version numbers, previews, or file contents) in your text so the user can see them without expanding.
+
+## Step 1: Check Node.js
+
+Run this command to check if Node.js 18+ is available:
+
+```bash
+node --version 2>/dev/null || echo "not_installed"
+```
+
+Tell the user the detected version in your text response.
+
+### If Node.js is NOT installed or version is below 18
+
+Display:
+
+````markdown
+Claude Powerline requires **Node.js 18+** to run.
+
+Install it from https://nodejs.org or via your package manager:
+
+```bash
+# macOS
+brew install node
+
+# Ubuntu/Debian
+curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
+sudo apt-get install -y nodejs
+```
+````
+
+Then ask:
+
+- **Question**: "Install Node.js or check again?"
+- **Header**: "Node.js"
+- **Options**:
+  - "I installed it, check again" -> Re-run the version check from the top of Step 1
+  - "Exit wizard" -> Tell them to install Node.js 18+ and exit
+
+### If Node.js 18+ IS installed
+
+Continue to the next step.
+
+## Step 2: Nerd Font Detection
+
+> [!IMPORTANT]
+> You cannot display nerd font glyphs properly in your text output.
+> You MUST run the cat command below and let the terminal render it.
+> After running it, tell the user to expand the bash output if they cannot see the icons.
+
+```bash
+cat ${CLAUDE_PLUGIN_ROOT}/templates/nerd-fonts-sample.txt
+```
+
+After running the command, tell the user: "Check the bash output above for Nerd Font icons (folder, code, branch, robot). You may need to click/expand the bash output to see them."
+
+Then ask:
+
+- **Question**: "Can you see the icons clearly (folder, code, branch, robot)?"
+- **Header**: "Nerd Font"
+- **Options**:
+  - "Yes, I can see them" -> Set `charset=unicode`. Continue to Step 3
+  - "No, I see boxes or blank spaces" -> Set `charset=text`. Continue to Step 3
+
+## Step 3: Theme Selection
+
+Display the available themes and tell the user to type their choice:
+
+````markdown
+**Available themes:**
+
+1. **dark** -- Dark background, high contrast (default)
+2. **light** -- Light background for light terminals
+3. **nord** -- Cool blue palette inspired by Arctic colors
+4. **tokyo-night** -- Modern dark theme with vibrant accents
+5. **rose-pine** -- Soft, muted palette with rose and pine tones
+6. **gruvbox** -- Warm retro colors with earthy tones
+````
+
+Then ask:
+
+- **Question**: "Which theme? Type a name or pick from the list."
+- **Header**: "Theme"
+- **Options**:
+  - "dark" -> Set `chosen_theme=dark`
+  - "light" -> Set `chosen_theme=light`
+  - "nord" -> Set `chosen_theme=nord`
+  - "tokyo-night" -> Set `chosen_theme=tokyo-night`
+
+If the user types "rose-pine" or "gruvbox" (or any valid theme name) in the free text field, accept that as their choice. Valid themes: dark, light, nord, tokyo-night, rose-pine, gruvbox.
+
+## Step 4: Style Selection
+
+Show a preview of all four styles using the bundled preview script.
+
+> [!IMPORTANT]
+> You cannot render ANSI escape codes or nerd font glyphs in your text output.
+> You MUST run the preview command below and let the terminal display the result.
+> Do NOT attempt to describe what the styles look like. Let the user see them.
+> After running, tell the user to expand the bash output if they cannot see the previews.
+
+```bash
+${CLAUDE_PLUGIN_ROOT}/bin/preview.sh --compare-styles --theme=${chosen_theme} --charset=${charset}
+```
+
+After running the command, tell the user: "The four style previews are in the bash output above. Expand it if needed."
+
+Then ask:
+
+- **Question**: "Which style do you prefer?"
+- **Header**: "Style"
+- **Options**:
+  - "minimal" -> Set `chosen_style=minimal`
+  - "powerline" -> Set `chosen_style=powerline`
+  - "capsule" -> Set `chosen_style=capsule`
+  - "tui" -> Set `chosen_style=tui`
+
+If the user chose `charset=text`, add a note that powerline and capsule use text fallback separators.
+
+**If the user chose "tui":** skip Steps 5 and 6. TUI mode is opinionated and always displays all data regardless of segment configuration. Tell the user: "TUI mode shows all available data automatically. Segment and bar style selection are not needed." Then continue to Step 7.
+
+## Step 5: Segment Selection
+
+> [!NOTE]
+> Skip this step if the user chose "tui" style.
+
+Display the three presets:
+
+````markdown
+**Choose a segment preset:**
+
+1. **Essential** -- Directory, git, model, context window
+   Clean and lightweight. Just the basics.
+
+2. **Standard** -- Essential + session cost, daily cost tracking
+   Adds cost visibility without clutter. Good default for most users.
+
+3. **Full** -- Standard + block usage, metrics, version, weekly usage
+   Everything on. For users who want maximum information density.
+````
+
+Then ask:
+
+- **Question**: "Which segment preset?"
+- **Header**: "Segments"
+- **Options**:
+  - "Essential" -> Set `chosen_preset=essential`
+  - "Standard" -> Set `chosen_preset=standard`
+  - "Full" -> Set `chosen_preset=full`
+
+### Preset to template mapping
+
+Each preset has a corresponding template config file in `${CLAUDE_PLUGIN_ROOT}/templates/`:
+
+- `essential` -> `config-essential.json`
+- `standard` -> `config-standard.json`
+- `full` -> `config-full.json`
+- `tui` (style) -> `config-tui.json`
+
+## Step 6: Bar Display Style
+
+> [!NOTE]
+> Skip this step if the user chose "tui" style. Default to `text` if skipped.
+
+Display the available bar styles for progress indicators (used by context, block, and weekly segments):
+
+````markdown
+**Bar display styles** (for context window, block usage, and weekly usage):
+
+1. **text** -- Numbers only, no bar (default). Example: `65,000 (61%)`
+2. **bar** -- Classic bar. Example: `▓▓▓▓▓░░░░░ 50%`
+3. **blocks** -- Block fill. Example: `█████░░░░░ 50%`
+4. **dots** -- Dot fill. Example: `●●●●●○○○○○ 50%`
+5. **geometric** -- Geometric. Example: `▰▰▰▰▰▱▱▱▱▱ 50%`
+6. **line** -- Line style. Example: `━━━━━┄┄┄┄┄ 50%`
+````
+
+Then ask:
+
+- **Question**: "Which bar style for progress indicators?"
+- **Header**: "Display Style"
+- **Options**:
+  - "text" -> Set `chosen_bar_style=text`
+  - "bar" -> Set `chosen_bar_style=bar`
+  - "blocks" -> Set `chosen_bar_style=blocks`
+  - "dots" -> Set `chosen_bar_style=dots`
+
+If the user types "geometric", "line", "filled", "squares", "capped", "ball", or "blocks-line" in the free text field, accept that as their choice. All valid display styles: text, ball, bar, blocks, blocks-line, capped, dots, filled, geometric, line, squares.
+
+Apply `chosen_bar_style` to the `displayStyle` field of context, block, and weekly segments in the config.
+
+## Step 7: Budget
+
+> [!NOTE]
+> Skip this step if the user chose "Essential" preset or "tui" style. The essential template has no budget placeholder, and TUI uses defaults.
+
+Ask the user about their daily budget for cost tracking:
+
+- **Question**: "Set a daily spending budget? (used by the today segment for percentage warnings)"
+- **Header**: "Budget"
+- **Options**:
+  - "$25/day" -> Set `today_budget=25`
+  - "$50/day" -> Set `today_budget=50`
+  - "$100/day" -> Set `today_budget=100`
+  - "No budget" -> Set `today_budget=null` (omit amount from config)
+
+## Step 8: Write Configuration
+
+### Check for existing config
+
+```bash
+test -f ~/.claude/claude-powerline.json && echo "exists" || echo "not_found"
+```
+
+If it exists, ask:
+
+- **Question**: "Found existing ~/.claude/claude-powerline.json. What should I do?"
+- **Header**: "Existing Config"
+- **Options**:
+  - "Replace it" -> Continue
+  - "Back it up first" -> Run `cp ~/.claude/claude-powerline.json ~/.claude/claude-powerline.json.bak` then continue
+  - "Keep it and exit" -> Exit the wizard
+
+### Build and write the config
+
+1. **Pick the template file.** If the user chose "tui" style, use `config-tui.json`. Otherwise use the preset template: `config-essential.json`, `config-standard.json`, or `config-full.json`.
+
+2. **Read the template** using the Read tool:
+
+```text
+${CLAUDE_PLUGIN_ROOT}/templates/<template-file>
+```
+
+1. **Replace placeholders** in the template content:
+
+   | Placeholder | Replace with |
+   |-------------|-------------|
+   | `replace:THEME` | The chosen theme (e.g., `tokyo-night`) |
+   | `replace:STYLE` | The chosen style (e.g., `capsule`). Not present in tui template. |
+   | `replace:CHARSET` | `unicode` or `text` |
+   | `replace:BAR_STYLE` | The chosen bar style (e.g., `blocks`). Default `text` if Step 6 was skipped. Not present in tui template. |
+   | `replace:TODAY_BUDGET` | The budget number (e.g., `50`). Not present in essential template. **Important:** replace `"replace:TODAY_BUDGET"` (including the surrounding quotes) with the bare number so the result is `"amount": 50` not `"amount": "50"`. |
+
+1. **Handle "No budget"**: If the user chose "No budget" in Step 7, remove the entire `"amount": "replace:TODAY_BUDGET",` line (including the trailing comma) from the budget section. If Step 7 was skipped (essential preset), do not modify the budget section.
+
+1. **Write the result** to `~/.claude/claude-powerline.json` using the Write tool. Do NOT read or merge with any existing config.
+
+## Step 9: Update settings.json
+
+Read `~/.claude/settings.json` if it exists. Add or update ONLY the `statusLine` key:
+
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "npx -y @owloops/claude-powerline@latest"
+  }
+}
+```
+
+If the file does not exist, create it with only the statusLine configuration.
+If it exists, preserve ALL other settings (hooks, permissions, plugins, etc.) and only add or update the `statusLine` key.
+
+Use the Read tool to load the existing file, merge the statusLine key, and Write to save it back.
+
+## Step 10: Test Installation
+
+Run a test with sample data to verify the statusline renders:
+
+> [!IMPORTANT]
+> You MUST run this command and tell the user to check the output.
+
+```bash
+${CLAUDE_PLUGIN_ROOT}/bin/preview.sh --theme=${chosen_theme} --style=${chosen_style} --charset=${charset}
+```
+
+Tell the user: "Check the bash output above for your statusline preview. Expand it if needed."
+
+If it produced output, tell the user the setup is working.
+
+## Step 11: Success Message
+
+Display:
+
+````markdown
+Setup complete.
+
+**Files created/updated:**
+- `~/.claude/claude-powerline.json` (powerline config)
+- `~/.claude/settings.json` (claude settings)
+
+**What now:**
+1. Restart Claude Code if the statusline does not appear.
+2. Run `/powerline` any time to reconfigure.
+3. Edit `~/.claude/claude-powerline.json` by hand for advanced options.
+
+Documentation: https://github.com/Owloops/claude-powerline
+````

package/plugin/templates/config-essential.json

@@ -0,0 +1,36 @@
+{
+  "theme": "replace:THEME",
+  "display": {
+    "style": "replace:STYLE",
+    "charset": "replace:CHARSET",
+    "colorCompatibility": "auto",
+    "autoWrap": true,
+    "padding": 1,
+    "lines": [
+      {
+        "segments": {
+          "directory": { "enabled": true, "style": "fish" },
+          "git": { "enabled": true },
+          "model": { "enabled": true }
+        }
+      },
+      {
+        "segments": {
+          "context": {
+            "enabled": true,
+            "showPercentageOnly": false,
+            "displayStyle": "replace:BAR_STYLE",
+            "autocompactBuffer": 33000
+          }
+        }
+      }
+    ]
+  },
+  "budget": {
+    "session": { "warningThreshold": 80 }
+  },
+  "modelContextLimits": {
+    "sonnet": 1000000,
+    "opus": 200000
+  }
+}

package/plugin/templates/config-full.json

@@ -0,0 +1,55 @@
+{
+  "theme": "replace:THEME",
+  "display": {
+    "style": "replace:STYLE",
+    "charset": "replace:CHARSET",
+    "colorCompatibility": "auto",
+    "autoWrap": true,
+    "padding": 1,
+    "lines": [
+      {
+        "segments": {
+          "directory": { "enabled": true, "style": "fish" },
+          "git": { "enabled": true },
+          "model": { "enabled": true },
+          "session": { "enabled": true, "type": "tokens", "costSource": "calculated" }
+        }
+      },
+      {
+        "segments": {
+          "today": { "enabled": true, "type": "cost" },
+          "block": { "enabled": true, "type": "cost", "burnType": "cost", "displayStyle": "replace:BAR_STYLE" },
+          "weekly": { "enabled": true, "displayStyle": "replace:BAR_STYLE" },
+          "context": {
+            "enabled": true,
+            "showPercentageOnly": false,
+            "displayStyle": "replace:BAR_STYLE",
+            "autocompactBuffer": 33000
+          }
+        }
+      },
+      {
+        "segments": {
+          "metrics": {
+            "enabled": true,
+            "showResponseTime": false,
+            "showLastResponseTime": false,
+            "showDuration": true,
+            "showMessageCount": true,
+            "showLinesAdded": false,
+            "showLinesRemoved": false
+          },
+          "version": { "enabled": true }
+        }
+      }
+    ]
+  },
+  "budget": {
+    "session": { "warningThreshold": 80 },
+    "today": { "amount": "replace:TODAY_BUDGET", "warningThreshold": 80 }
+  },
+  "modelContextLimits": {
+    "sonnet": 1000000,
+    "opus": 200000
+  }
+}

package/plugin/templates/config-standard.json

@@ -0,0 +1,39 @@
+{
+  "theme": "replace:THEME",
+  "display": {
+    "style": "replace:STYLE",
+    "charset": "replace:CHARSET",
+    "colorCompatibility": "auto",
+    "autoWrap": true,
+    "padding": 1,
+    "lines": [
+      {
+        "segments": {
+          "directory": { "enabled": true, "style": "fish" },
+          "git": { "enabled": true },
+          "model": { "enabled": true },
+          "session": { "enabled": true, "type": "tokens", "costSource": "calculated" }
+        }
+      },
+      {
+        "segments": {
+          "today": { "enabled": true, "type": "cost" },
+          "context": {
+            "enabled": true,
+            "showPercentageOnly": false,
+            "displayStyle": "replace:BAR_STYLE",
+            "autocompactBuffer": 33000
+          }
+        }
+      }
+    ]
+  },
+  "budget": {
+    "session": { "warningThreshold": 80 },
+    "today": { "amount": "replace:TODAY_BUDGET", "warningThreshold": 80 }
+  },
+  "modelContextLimits": {
+    "sonnet": 1000000,
+    "opus": 200000
+  }
+}

package/plugin/templates/config-tui.json

@@ -0,0 +1,18 @@
+{
+  "theme": "replace:THEME",
+  "display": {
+    "style": "tui",
+    "charset": "replace:CHARSET",
+    "colorCompatibility": "auto",
+    "autoWrap": true,
+    "padding": 0
+  },
+  "budget": {
+    "session": { "warningThreshold": 80 },
+    "today": { "amount": "replace:TODAY_BUDGET", "warningThreshold": 80 }
+  },
+  "modelContextLimits": {
+    "sonnet": 1000000,
+    "opus": 200000
+  }
+}

package/plugin/templates/nerd-fonts-sample.txt

@@ -0,0 +1,5 @@
+Can you see these icons clearly?
+
+  folder    code    branch   󰚩 robot
+
+If you see boxes or blank spaces instead of icons, choose "No" below.