claudeline 1.0.0 → 1.2.0

package/.claude/skills/configure-statusline/SKILL.md

@@ -0,0 +1,187 @@
+---
+name: configure-statusline
+description: Configure claudeline status line for Claude Code. Use when user wants to set up, customize, or change their status line display. Helps users choose themes, build custom formats, and install to global or project scope.
+tools: Read, Bash, AskUserQuestion
+---
+
+# Configure Claudeline Status Line
+
+Help users configure their Claude Code status line using claudeline.
+
+## Workflow
+
+### Step 1: Understand User's Needs
+
+Ask the user what they want:
+
+```
+What would you like to do?
+1. **Quick setup** - Install a preset theme
+2. **Custom format** - Build a custom status line
+3. **See current** - Check what's currently configured
+4. **Uninstall** - Remove status line configuration
+```
+
+### Step 2: Determine Scope
+
+Ask where to install:
+
+```
+Where should the status line be configured?
+1. **Global** (~/.claude/settings.json) - Applies to all projects
+2. **Project** (.claude/settings.json) - Only this project
+```
+
+### Step 3A: Quick Setup (Theme Selection)
+
+If user wants a theme, show available options:
+
+| Theme | Description | Preview |
+|-------|-------------|---------|
+| `minimal` | Just model and directory | `Sonnet 4 myproject` |
+| `default` | Model, directory, git info | `[Sonnet 4] 📁 myproject \| 🌿 main ✓` |
+| `powerline` | Powerline style with colors | `Sonnet 4  myproject  main ✓` |
+| `full` | Everything including cost/context | `[Sonnet 4] ~/project → main ✓ \| [████░░] 45% \| $0.42` |
+| `git` | Git-focused with detailed status | `[Sonnet 4] 📁 myproject \| 🌿 main ✓ ↑2` |
+| `tokens` | Token/context focused | `Sonnet 4 \| 🟢 50k/200k \| +133` |
+| `dashboard` | Full dashboard view | `[Sonnet 4] myproject \| main ✓ \| 45% \| $0.42 \| 14:32` |
+| `compact` | Minimal with slashes | `Sonnet 4 / myproject / main` |
+| `colorful` | Vibrant colors | Colored model, dir, branch, status |
+
+Install with:
+```bash
+npx claudeline --theme <name> --install [--project]
+```
+
+### Step 3B: Custom Format Builder
+
+If user wants custom, guide them through building a format string.
+
+#### Available Components
+
+**Model/Session:**
+- `claude:model` - Model name (Sonnet 4)
+- `claude:model-letter` - First letter (S)
+
+**Directory:**
+- `fs:dir` - Current directory name
+- `fs:home` - Path with ~ for home
+- `fs:project` - Project name
+
+**Git:**
+- `git:branch` - Branch name
+- `git:status` - ✓ or *
+- `git:ahead-behind` - ↑2↓1
+- `git:dirty` - Combined status
+
+**Context:**
+- `ctx:percent` - Usage % (45%)
+- `ctx:bar` - Progress bar [████░░]
+- `ctx:emoji` - 🟢🟡🟠🔴
+- `ctx:tokens` - 50k/200k
+
+**Cost:**
+- `cost:total` - $0.42
+- `cost:duration` - 5m
+- `cost:lines` - +133
+
+**Time:**
+- `time:now` - 14:32
+- `time:date` - Feb 1
+
+**Separators:** `sep:pipe` (\|), `sep:arrow` (→), `sep:dot` (•), `sep:slash` (/)
+
+**Emojis:** `emoji:folder` (📁), `emoji:branch` (🌿), `emoji:rocket` (🚀)
+
+**Styling:** Prefix with `green:`, `bold:`, `cyan:`, etc.
+
+**Grouping:** `[...]` adds brackets, `if:git(...)` for conditionals
+
+#### Example Formats
+
+```bash
+# Simple
+"claude:model fs:dir git:branch"
+
+# With separators
+"claude:model sep:pipe fs:dir sep:arrow git:branch"
+
+# With colors
+"bold:cyan:claude:model fs:dir green:git:branch"
+
+# With conditionals (only show git info in git repos)
+"claude:model fs:dir if:git(sep:pipe git:branch git:status)"
+
+# Full custom
+"[bold:cyan:claude:model] emoji:folder fs:dir sep:arrow green:git:branch git:status sep:pipe ctx:percent"
+```
+
+Install custom format:
+```bash
+npx claudeline "<format>" --install [--project]
+```
+
+### Step 4: Verify Installation
+
+After installing, show the user:
+
+1. What was written to settings.json
+2. Remind them to restart Claude Code
+
+```bash
+# Check current configuration
+cat ~/.claude/settings.json | grep -A5 statusLine
+
+# Or for project
+cat .claude/settings.json | grep -A5 statusLine
+```
+
+### Step 5: Test Before Installing (Optional)
+
+User can test their format:
+
+```bash
+# See sample data
+npx claudeline --preview
+
+# Test with sample data
+echo '{"model":{"display_name":"Sonnet 4"},"workspace":{"current_dir":"/test/project"}}' | npx claudeline run "claude:model fs:dir"
+```
+
+## Commands Reference
+
+```bash
+# Install theme globally
+npx claudeline --theme minimal --install
+
+# Install theme to project only
+npx claudeline --theme powerline --install --project
+
+# Install custom format
+npx claudeline "claude:model fs:dir git:branch" --install
+
+# List all themes
+npx claudeline --themes
+
+# List all components
+npx claudeline --list
+
+# Uninstall
+npx claudeline --uninstall [--project]
+
+# Preview sample data
+npx claudeline --preview
+```
+
+## Troubleshooting
+
+**Status line not showing?**
+- Restart Claude Code after installing
+- Check settings.json has the statusLine config
+
+**Command not found?**
+- Ensure Node.js/npm is installed
+- Try `npx claudeline --help`
+
+**Want to use bun instead of npx?**
+- Use `--use-bunx` flag when installing

package/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "claudeline",
+  "description": "Customizable status line for Claude Code. Configure themes and custom formats for your terminal status display.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Luca Silverentand"
+  }
+}

package/README.md

@@ -1,12 +1,12 @@
 # claudeline
 
-Customizable status line for [Claude Code](https://claude.ai/code). Display model info, git status, context usage, costs, and more in your terminal.
+Customizable status line for [Claude Code](https://claude.ai/code). Display model info, git status, context usage, costs, API usage limits, and more in your terminal.
 
 ## Installation
 
 ```bash
 # Install with a theme
-npx claudeline --theme minimal --install
+npx claudeline --theme luca --install
 
 # Or with a custom format
 npx claudeline "claude:model fs:dir git:branch" --install
@@ -39,17 +39,21 @@ npx claudeline --uninstall
 |-------|--------|
 | `minimal` | `claude:model fs:dir` |
 | `default` | `[claude:model] emoji:folder fs:dir if:git(sep:pipe emoji:branch git:branch git:status)` |
-| `powerline` | `bold:cyan:claude:model sep:powerline fs:dir if:git(sep:powerline green:git:branch git:status)` |
+| `powerline` | `bold:cyan:claude:model sep:powerline fs:dir if:git(...)` |
 | `full` | `[bold:cyan:claude:model] fs:home sep:arrow green:git:branch git:status sep:pipe ctx:bar ctx:percent sep:pipe cost:total` |
-| `git` | `[claude:model] emoji:folder fs:dir sep:pipe emoji:branch git:branch git:status git:ahead-behind if:dirty(sep:pipe git:staged git:modified git:untracked)` |
+| `git` | `[claude:model] emoji:folder fs:dir sep:pipe emoji:branch git:branch git:status git:ahead-behind if:dirty(...)` |
 | `tokens` | `claude:model sep:pipe ctx:emoji ctx:tokens sep:pipe cost:lines` |
 | `dev` | `[fs:dir] git:branch sep:pipe env:node sep:pipe time:now` |
 | `dashboard` | `[bold:claude:model] fs:dir sep:pipe git:branch git:status sep:pipe ctx:percent sep:pipe cost:total sep:pipe time:now` |
 | `context-focus` | `claude:model sep:pipe ctx:bar sep:pipe ctx:tokens sep:pipe ctx:emoji` |
 | `cost` | `claude:model sep:pipe cost:total sep:pipe cost:duration sep:pipe cost:lines-both` |
 | `simple` | `claude:model fs:dir git:branch` |
+| `verbose` | `[claude:model] [claude:version] sep:pipe fs:home sep:pipe git:branch git:status git:ahead-behind sep:pipe ctx:bar ctx:percent sep:pipe cost:total cost:duration sep:pipe time:now` |
 | `compact` | `claude:model sep:slash fs:dir sep:slash git:branch` |
 | `colorful` | `bold:magenta:claude:model sep:arrow cyan:fs:dir sep:arrow green:git:branch yellow:git:status sep:arrow blue:ctx:percent` |
+| `luca` | Nerd font icons, colored repo:branch, dirty state, cost, 5h/weekly usage bars |
+
+When you install with `--theme`, claudeline stores a `theme:name` reference so your status line automatically picks up theme updates when you upgrade.
 
 ## Format Syntax
 
@@ -87,6 +91,7 @@ Show components only when conditions are met:
 ```
 if:git(git:branch git:status)     # only in git repos
 if:dirty(text:UNCOMMITTED)        # only when working tree is dirty
+if:subdir(fs:relative)            # only when in a subdirectory (not git root)
 if:node(env:node)                 # only in Node.js projects
 if:python(env:python)             # only in Python projects
 if:rust(emoji:rust)               # only in Rust projects
@@ -120,7 +125,7 @@ Available separators:
 - `powerline` → ``
 - `powerline-left` → ``
 - `space` → ` `
-- `none` → (empty)
+- `none` → (empty, useful for glueing components together)
 
 ## Components Reference
 
@@ -151,7 +156,7 @@ Available separators:
 | `ctx:emoji` | Status emoji (🟢🟡🟠🔴) |
 | `ctx:used-tokens` | Total used tokens |
 
-### Cost/Usage
+### Cost
 
 | Component | Description |
 |-----------|-------------|
@@ -164,6 +169,26 @@ Available separators:
 | `cost:removed` | Lines removed |
 | `cost:lines-both` | Lines added and removed |
 
+### Usage/Limits
+
+Fetches your 5-hour and 7-day API utilization from Claude's OAuth API. Data is cached for 5 minutes in `$TMPDIR/claudeline-usage-cache.json`, shared across all sessions system-wide. The OAuth token is read automatically from macOS Keychain.
+
+| Component | Description | Example |
+|-----------|-------------|---------|
+| `usage:5h` | 5-hour utilization % | `12%` |
+| `usage:week` | 7-day utilization % | `58%` |
+| `usage:7d` | Alias for `usage:week` | `58%` |
+| `usage:5h-reset` | Time until 5h reset | `3h 32m` |
+| `usage:week-reset` | Time until weekly reset | `2d 5h` |
+| `usage:7d-reset` | Alias for `usage:week-reset` | `2d 5h` |
+| `usage:5h-bar` | 5h progress bar with H label | `H▰▰▱▱▱▱▱▱` |
+| `usage:5h-bar:N` | 5h bar with width N | `H▰▱▱▱▱` |
+| `usage:week-bar` | Weekly progress bar with W label | `W▰▰▰▰▰▱▱▱` |
+| `usage:week-bar:N` | Weekly bar with width N | `W▰▰▰▱▱` |
+| `usage:5h-emoji` | 5h status emoji (🟢🟡🟠🔴) | `🟢` |
+| `usage:week-emoji` | Weekly status emoji | `🟡` |
+| `usage:7d-emoji` | Alias for `usage:week-emoji` | `🟡` |
+
 ### File System
 
 | Component | Description |
@@ -191,7 +216,8 @@ Available separators:
 | `git:staged` | Staged files (●N) |
 | `git:modified` | Modified files (+N) |
 | `git:untracked` | Untracked files (?N) |
-| `git:dirty` | Combined dirty status |
+| `git:dirty` | Combined dirty status with per-type colors (green staged, red untracked, yellow modified) |
+| `git:repo-branch` | Condensed `repo:branch` format |
 | `git:commit` | Short commit hash |
 | `git:commit-long` | Full commit hash |
 | `git:tag` | Current tag |
@@ -249,9 +275,31 @@ Available separators:
 | `time:minute` | Minute |
 | `time:elapsed` | Session elapsed time |
 
+### Nerd Font Icons
+
+Use `nerd:name` for Nerd Font glyphs. Requires a [Nerd Font](https://www.nerdfonts.com/) in your terminal.
+
+**Files:** `folder`, `folder-open`, `file`, `file-code`
+
+**Git:** `branch`, `repo`, `commit`, `merge`, `tag`, `stash`, `pr`, `diff`, `compare`
+
+**Status:** `check`, `x`, `warn`, `error`, `info`, `question`, `bell`, `pin`
+
+**Decorative:** `star`, `fire`, `rocket`, `sparkle`, `lightning`, `heart`, `diamond`, `circle`, `square`, `triangle`
+
+**Tech:** `node`, `python`, `rust`, `go`, `ruby`, `java`, `docker`, `terminal`, `code`, `database`, `cloud`, `server`, `package`, `gear`, `lock`, `unlock`, `key`, `shield`
+
+**Arrows:** `up`, `down`, `left`, `right`, `arrow-right`, `arrow-left`
+
+**Time:** `clock`, `calendar`, `history`
+
+**OS:** `apple`, `linux`, `windows`
+
+**Other:** `search`, `eye`, `bug`, `wrench`, `plug`, `wifi`, `bluetooth`, `cpu`, `memory`, `home`, `user`
+
 ### Emojis
 
-Use `emoji:name` for any of these:
+Use `emoji:name` for Unicode emojis (no Nerd Font required):
 
 **Files:** `folder` 📁, `file` 📄, `home` 🏠
 
@@ -319,7 +367,7 @@ When you run `--install`, claudeline updates your `~/.claude/settings.json`:
 {
   "statusLine": {
     "type": "command",
-    "command": "npx claudeline run 'claude:model fs:dir'",
+    "command": "npx claudeline run theme:luca",
     "padding": 0
   }
 }
@@ -337,6 +385,9 @@ npx claudeline --preview
 
 # Test with sample data
 echo '{"model":{"display_name":"Sonnet 4"}}' | npx claudeline run "claude:model fs:dir"
+
+# Test a theme
+echo '{"model":{"display_name":"Opus"}}' | npx claudeline run theme:dashboard
 ```
 
 ## Package Managers

package/dist/index.js

@@ -148,6 +148,9 @@ function parseComponent(token) {
   if (parts[0] === "emoji") {
     return { type: "emoji", key: parts[1] || "", styles };
   }
+  if (parts[0] === "nerd") {
+    return { type: "nerd", key: parts[1] || "", styles };
+  }
   if (parts[0] === "sep") {
     return { type: "sep", key: parts[1] || "pipe", styles };
   }
@@ -200,6 +203,7 @@ function listComponents() {
         "tag",
         "remote",
         "repo",
+        "repo-branch",
         "user",
         "email",
         "remote-url"
@@ -255,6 +259,24 @@ function listComponents() {
         "elapsed"
       ]
     },
+    {
+      name: "Usage/Limits",
+      prefix: "usage",
+      items: [
+        "5h",
+        "week",
+        "7d",
+        "5h-reset",
+        "week-reset",
+        "7d-reset",
+        "5h-bar",
+        "5h-bar:N",
+        "week-bar",
+        "week-bar:N",
+        "5h-emoji",
+        "week-emoji"
+      ]
+    },
     {
       name: "Separators",
       prefix: "sep",
@@ -327,6 +349,65 @@ function listComponents() {
         "money"
       ]
     },
+    {
+      name: "Nerd Font Icons",
+      prefix: "nerd",
+      items: [
+        "folder",
+        "folder-open",
+        "file",
+        "file-code",
+        "branch",
+        "repo",
+        "commit",
+        "merge",
+        "tag",
+        "stash",
+        "pr",
+        "diff",
+        "check",
+        "x",
+        "warn",
+        "error",
+        "info",
+        "star",
+        "fire",
+        "rocket",
+        "sparkle",
+        "lightning",
+        "heart",
+        "node",
+        "python",
+        "rust",
+        "go",
+        "ruby",
+        "java",
+        "docker",
+        "terminal",
+        "code",
+        "database",
+        "cloud",
+        "server",
+        "package",
+        "gear",
+        "lock",
+        "key",
+        "shield",
+        "clock",
+        "calendar",
+        "apple",
+        "linux",
+        "windows",
+        "search",
+        "eye",
+        "bug",
+        "wrench",
+        "cpu",
+        "memory",
+        "home",
+        "user"
+      ]
+    },
     {
       name: "Text",
       prefix: "text",
@@ -391,7 +472,7 @@ var THEMES = {
   nerd: "emoji:node env:node-short sep:dot emoji:folder fs:dir sep:dot emoji:branch git:branch git:status",
   compact: "claude:model sep:slash fs:dir sep:slash git:branch",
   colorful: "bold:magenta:claude:model sep:arrow cyan:fs:dir sep:arrow green:git:branch yellow:git:status sep:arrow blue:ctx:percent",
-  luca: "claude:model-letter git:repo git:branch git:dirty cost:total"
+  luca: "bold:magenta:claude:model-letter sep:pipe cyan:nerd:repo cyan:git:repo sep:none dim:text:: sep:none green:git:branch if:subdir(sep:none white:text:/ sep:none white:fs:relative) if:dirty(sep:pipe git:dirty) sep:pipe white:cost:total sep:newline bold:white:usage:5h-bar:8 usage:5h dim:usage:5h-reset sep:pipe bold:white:usage:week-bar:8 usage:week dim:usage:week-reset"
 };
 function getTheme(name) {
   return THEMES[name] || null;
@@ -543,10 +624,10 @@ function getSampleDataJson() {
 }
 
 // src/runtime.ts
-import * as path2 from "path";
-import * as os2 from "os";
-import * as fs2 from "fs";
-import { execSync } from "child_process";
+import * as path3 from "path";
+import * as os3 from "os";
+import * as fs3 from "fs";
+import { execSync as execSync2 } from "child_process";
 
 // src/separators.ts
 var SEPARATORS = {
@@ -569,6 +650,9 @@ var SEPARATORS = {
   bullet: " \u25E6 ",
   diamond: " \u25C7 ",
   star: " \u2605 ",
+  // Line break
+  newline: "\n",
+  br: "\n",
   // Powerline-style
   powerline: "",
   "powerline-left": "",
@@ -640,6 +724,225 @@ function getEmoji(name) {
   return EMOJIS[name] || "";
 }
 
+// src/usage.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
+import * as os2 from "os";
+import { execSync } from "child_process";
+var CACHE_TTL_MS = 5 * 60 * 1e3;
+var CACHE_FILE = path2.join(os2.tmpdir(), "claudeline-usage-cache.json");
+function readCache() {
+  try {
+    const raw = fs2.readFileSync(CACHE_FILE, "utf8");
+    const cached = JSON.parse(raw);
+    if (Date.now() - cached.fetched_at < CACHE_TTL_MS) {
+      return cached;
+    }
+  } catch {
+  }
+  return null;
+}
+function writeCache(data) {
+  try {
+    fs2.writeFileSync(CACHE_FILE, JSON.stringify({ data, fetched_at: Date.now() }));
+  } catch {
+  }
+}
+function getOAuthToken() {
+  try {
+    const raw = execSync(
+      'security find-generic-password -s "Claude Code-credentials" -w 2>/dev/null',
+      { encoding: "utf8" }
+    ).trim();
+    const parsed = JSON.parse(raw);
+    if (typeof parsed === "string") return parsed;
+    if (parsed.claudeAiOauth?.accessToken) return parsed.claudeAiOauth.accessToken;
+    if (parsed.accessToken) return parsed.accessToken;
+    if (parsed.access_token) return parsed.access_token;
+    return null;
+  } catch {
+    return null;
+  }
+}
+function fetchUsage() {
+  const token = getOAuthToken();
+  if (!token) return null;
+  try {
+    const result = execSync(
+      `curl -s --max-time 5 -H "Authorization: Bearer ${token}" -H "anthropic-beta: oauth-2025-04-20" "https://api.anthropic.com/api/oauth/usage"`,
+      { encoding: "utf8" }
+    ).trim();
+    const data = JSON.parse(result);
+    if (data.five_hour && data.seven_day) {
+      return data;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function getUsageData() {
+  const cached = readCache();
+  if (cached) return cached.data;
+  const data = fetchUsage();
+  if (data) {
+    writeCache(data);
+  }
+  return data;
+}
+function formatTimeUntil(isoDate) {
+  const reset = new Date(isoDate).getTime();
+  const now = Date.now();
+  let diff = Math.max(0, reset - now);
+  if (diff === 0) return "now";
+  const days = Math.floor(diff / 864e5);
+  diff %= 864e5;
+  const hours = Math.floor(diff / 36e5);
+  diff %= 36e5;
+  const minutes = Math.floor(diff / 6e4);
+  if (days > 0) return `${days}d ${hours}h`;
+  if (hours > 0) return `${hours}h ${minutes}m`;
+  return `${minutes}m`;
+}
+function makeBar(pct, width, label) {
+  const filled = Math.round(pct / 100 * width);
+  const bar = "\u25B0".repeat(filled) + "\u25B1".repeat(width - filled);
+  return label ? label + bar : bar;
+}
+function evaluateUsageComponent(key, args) {
+  const data = getUsageData();
+  if (!data) return "";
+  switch (key) {
+    case "5h":
+      return Math.round(data.five_hour.utilization) + "%";
+    case "week":
+    case "7d":
+      return Math.round(data.seven_day.utilization) + "%";
+    case "5h-reset":
+      return formatTimeUntil(data.five_hour.resets_at);
+    case "week-reset":
+    case "7d-reset":
+      return formatTimeUntil(data.seven_day.resets_at);
+    case "5h-bar": {
+      const width = args ? parseInt(args, 10) || 10 : 10;
+      return makeBar(data.five_hour.utilization, width, "H");
+    }
+    case "week-bar":
+    case "7d-bar": {
+      const width = args ? parseInt(args, 10) || 10 : 10;
+      return makeBar(data.seven_day.utilization, width, "W");
+    }
+    case "5h-emoji": {
+      const pct = data.five_hour.utilization;
+      if (pct < 50) return "\u{1F7E2}";
+      if (pct < 75) return "\u{1F7E1}";
+      if (pct < 90) return "\u{1F7E0}";
+      return "\u{1F534}";
+    }
+    case "week-emoji":
+    case "7d-emoji": {
+      const pct = data.seven_day.utilization;
+      if (pct < 50) return "\u{1F7E2}";
+      if (pct < 75) return "\u{1F7E1}";
+      if (pct < 90) return "\u{1F7E0}";
+      return "\u{1F534}";
+    }
+    default:
+      return "";
+  }
+}
+
+// src/nerdfonts.ts
+var NERD_ICONS = {
+  // Files & Folders
+  "folder": "\uF07B",
+  "folder-open": "\uF07C",
+  "file": "\uF15B",
+  "file-code": "\uF1C9",
+  // Git
+  "branch": "\uE725",
+  "repo": "\uF401",
+  "commit": "\uF417",
+  "merge": "\uF419",
+  "tag": "\uF412",
+  "stash": "\uF01C",
+  "pr": "\uF407",
+  "diff": "\uF440",
+  "compare": "\uF47D",
+  // Status
+  "check": "\uF00C",
+  "x": "\uF00D",
+  "warn": "\uF071",
+  "error": "\uF057",
+  "info": "\uF05A",
+  "question": "\uF059",
+  "bell": "\uF0F3",
+  "pin": "\uF08D",
+  // Decorative
+  "star": "\uF005",
+  "fire": "\uF490",
+  "rocket": "\uF135",
+  "sparkle": "\uF005",
+  "lightning": "\uF0E7",
+  "heart": "\uF004",
+  "diamond": "\uF219",
+  "circle": "\uF111",
+  "square": "\uF0C8",
+  "triangle": "\uF0D8",
+  // Tech
+  "node": "\uE718",
+  "python": "\uE73C",
+  "rust": "\uE7A8",
+  "go": "\uE626",
+  "ruby": "\uE739",
+  "java": "\uE738",
+  "docker": "\uE7B0",
+  "terminal": "\uF120",
+  "code": "\uF121",
+  "database": "\uF1C0",
+  "cloud": "\uF0C2",
+  "server": "\uF233",
+  "package": "\uF487",
+  "gear": "\uF013",
+  "lock": "\uF023",
+  "unlock": "\uF09C",
+  "key": "\uF084",
+  "shield": "\uF132",
+  // Arrows
+  "up": "\uF062",
+  "down": "\uF063",
+  "left": "\uF060",
+  "right": "\uF061",
+  "arrow-right": "\uF061",
+  "arrow-left": "\uF060",
+  // Time
+  "clock": "\uF017",
+  "calendar": "\uF073",
+  "history": "\uF1DA",
+  // Money
+  "money": "\uF0D6",
+  "dollar": "\uF155",
+  // OS
+  "apple": "\uF179",
+  "linux": "\uF17C",
+  "windows": "\uF17A",
+  // Misc
+  "search": "\uF002",
+  "eye": "\uF06E",
+  "bug": "\uF188",
+  "wrench": "\uF0AD",
+  "plug": "\uF1E6",
+  "wifi": "\uF1EB",
+  "bluetooth": "\uF293",
+  "cpu": "\uF2DB",
+  "memory": "\uF538",
+  "home": "\uF015",
+  "user": "\uF007"
+};
+function getNerdIcon(name) {
+  return NERD_ICONS[name] || "";
+}
+
 // src/runtime.ts
 function formatTokens(n) {
   if (n >= 1e6) return Math.round(n / 1e6) + "M";
@@ -654,7 +957,7 @@ function formatDuration(ms) {
 }
 function execCommand(cmd) {
   try {
-    return execSync(cmd, { encoding: "utf8" }).trim();
+    return execSync2(cmd, { encoding: "utf8" }).trim();
   } catch {
     return "";
   }
@@ -690,13 +993,13 @@ function evaluateFsComponent(key, data) {
     case "path":
       return data.workspace?.current_dir || data.cwd || "";
     case "dir":
-      return path2.basename(data.workspace?.current_dir || data.cwd || "");
+      return path3.basename(data.workspace?.current_dir || data.cwd || "");
     case "project":
-      return path2.basename(data.workspace?.project_dir || "");
+      return path3.basename(data.workspace?.project_dir || "");
     case "project-path":
       return data.workspace?.project_dir || "";
     case "home":
-      return (data.workspace?.current_dir || data.cwd || "").replace(os2.homedir(), "~");
+      return (data.workspace?.current_dir || data.cwd || "").replace(os3.homedir(), "~");
     case "cwd":
       return data.cwd || "";
     case "relative": {
@@ -705,33 +1008,33 @@ function evaluateFsComponent(key, data) {
       if (proj && curr.startsWith(proj)) {
         return curr.slice(proj.length + 1) || ".";
       }
-      return path2.basename(curr);
+      return path3.basename(curr);
     }
     default:
       return "";
   }
 }
-function evaluateGitComponent(key) {
+function evaluateGitComponent(key, noColor = false) {
   switch (key) {
     case "branch":
       return execCommand("git branch --show-current 2>/dev/null");
     case "status":
       try {
-        execSync("git diff --quiet 2>/dev/null");
+        execSync2("git diff --quiet 2>/dev/null");
         return "\u2713";
       } catch {
         return "*";
       }
     case "status-emoji":
       try {
-        execSync("git diff --quiet 2>/dev/null");
+        execSync2("git diff --quiet 2>/dev/null");
         return "\u2728";
       } catch {
         return "\u{1F4DD}";
       }
     case "status-word":
       try {
-        execSync("git diff --quiet 2>/dev/null");
+        execSync2("git diff --quiet 2>/dev/null");
         return "clean";
       } catch {
         return "dirty";
@@ -774,9 +1077,16 @@ function evaluateGitComponent(key) {
       const untracked = parseInt(execCommand("git ls-files --others --exclude-standard 2>/dev/null | wc -l")) || 0;
       if (staged === 0 && modified === 0 && untracked === 0) return "";
       const parts = [];
-      if (staged > 0) parts.push("+" + staged);
-      if (untracked > 0) parts.push("-" + untracked);
-      if (modified > 0) parts.push("~" + modified);
+      if (noColor) {
+        if (staged > 0) parts.push("+" + staged);
+        if (untracked > 0) parts.push("-" + untracked);
+        if (modified > 0) parts.push("~" + modified);
+      } else {
+        const r = `\x1B[${RESET}m`;
+        if (staged > 0) parts.push(`\x1B[${COLORS.green}m+${staged}${r}`);
+        if (untracked > 0) parts.push(`\x1B[${COLORS.red}m-${untracked}${r}`);
+        if (modified > 0) parts.push(`\x1B[${COLORS.yellow}m~${modified}${r}`);
+      }
       return parts.join(" ");
     }
     case "commit":
@@ -788,7 +1098,12 @@ function evaluateGitComponent(key) {
     case "remote":
       return execCommand("git remote 2>/dev/null").split("\n")[0] || "";
     case "repo":
-      return path2.basename(execCommand("git rev-parse --show-toplevel 2>/dev/null"));
+      return path3.basename(execCommand("git rev-parse --show-toplevel 2>/dev/null"));
+    case "repo-branch": {
+      const r = path3.basename(execCommand("git rev-parse --show-toplevel 2>/dev/null"));
+      const b = execCommand("git branch --show-current 2>/dev/null");
+      return r && b ? `${r}:${b}` : r || b;
+    }
     case "user":
       return execCommand("git config user.name 2>/dev/null");
     case "email":
@@ -901,13 +1216,13 @@ function evaluateEnvComponent(key) {
       return match?.[1] || "";
     }
     case "user":
-      return os2.userInfo().username;
+      return os3.userInfo().username;
     case "hostname":
-      return os2.hostname();
+      return os3.hostname();
     case "hostname-short":
-      return os2.hostname().split(".")[0];
+      return os3.hostname().split(".")[0];
     case "shell":
-      return path2.basename(process.env.SHELL || "");
+      return path3.basename(process.env.SHELL || "");
     case "term":
       return process.env.TERM || "";
     case "os":
@@ -915,11 +1230,11 @@ function evaluateEnvComponent(key) {
     case "arch":
       return process.arch;
     case "os-release":
-      return os2.release();
+      return os3.release();
     case "cpus":
-      return os2.cpus().length.toString();
+      return os3.cpus().length.toString();
     case "memory":
-      return Math.round(os2.totalmem() / 1024 / 1024 / 1024) + "GB";
+      return Math.round(os3.totalmem() / 1024 / 1024 / 1024) + "GB";
     default:
       return "";
   }
@@ -971,33 +1286,37 @@ function evaluateCondition(condition) {
   switch (condition) {
     case "git":
       try {
-        execSync("git rev-parse --git-dir 2>/dev/null");
+        execSync2("git rev-parse --git-dir 2>/dev/null");
         return true;
       } catch {
         return false;
       }
     case "dirty":
       try {
-        execSync("git diff --quiet 2>/dev/null");
+        execSync2("git diff --quiet 2>/dev/null");
         return false;
       } catch {
         return true;
       }
     case "clean":
       try {
-        execSync("git diff --quiet 2>/dev/null");
+        execSync2("git diff --quiet 2>/dev/null");
         return true;
       } catch {
         return false;
       }
+    case "subdir": {
+      const root = execCommand("git rev-parse --show-toplevel 2>/dev/null");
+      return root !== "" && process.cwd() !== root;
+    }
     case "node":
-      return fs2.existsSync("package.json");
+      return fs3.existsSync("package.json");
     case "python":
-      return fs2.existsSync("pyproject.toml") || fs2.existsSync("setup.py") || fs2.existsSync("requirements.txt");
+      return fs3.existsSync("pyproject.toml") || fs3.existsSync("setup.py") || fs3.existsSync("requirements.txt");
     case "rust":
-      return fs2.existsSync("Cargo.toml");
+      return fs3.existsSync("Cargo.toml");
     case "go":
-      return fs2.existsSync("go.mod");
+      return fs3.existsSync("go.mod");
     default:
       return true;
   }
@@ -1012,7 +1331,7 @@ function evaluateComponent(comp, data, options) {
       result = evaluateFsComponent(comp.key, data);
       break;
     case "git":
-      result = evaluateGitComponent(comp.key);
+      result = evaluateGitComponent(comp.key, options.noColor);
       break;
     case "ctx":
       result = evaluateContextComponent(comp.key, data, comp.args);
@@ -1023,6 +1342,9 @@ function evaluateComponent(comp, data, options) {
     case "env":
       result = evaluateEnvComponent(comp.key);
       break;
+    case "usage":
+      result = evaluateUsageComponent(comp.key, comp.args);
+      break;
     case "time":
       result = evaluateTimeComponent(comp.key, data);
       break;
@@ -1032,6 +1354,9 @@ function evaluateComponent(comp, data, options) {
     case "emoji":
       result = options.noEmoji ? "" : getEmoji(comp.key);
       break;
+    case "nerd":
+      result = options.noEmoji ? "" : getNerdIcon(comp.key);
+      break;
     case "text":
       result = comp.key;
       break;
@@ -1064,7 +1389,7 @@ function evaluateComponents(components, data, options) {
     const comp = components[i];
     const prev = components[i - 1];
     const value = evaluateComponent(comp, data, options);
-    if (i > 0 && comp.type !== "sep" && prev?.type !== "sep" && value) {
+    if (i > 0 && comp.type !== "sep" && comp.type !== "conditional" && prev?.type !== "sep" && value) {
       parts.push(" ");
     }
     if (value) {
@@ -1083,7 +1408,7 @@ function evaluateFormat(format, data, options = {}) {
 }
 
 // src/index.ts
-var VERSION = "1.0.0";
+var VERSION = "1.1.0";
 async function readStdin() {
   return new Promise((resolve, reject) => {
     let input = "";
@@ -1099,9 +1424,19 @@ async function readStdin() {
 }
 program.command("run <format>").description("Evaluate a format string and output the status line").option("--disable-emoji", "Disable emoji output").option("--disable-color", "Disable color output").action(async (format, options) => {
   try {
+    let formatStr = format;
+    if (format.startsWith("theme:")) {
+      const themeName = format.slice(6);
+      const theme = getTheme(themeName);
+      if (!theme) {
+        console.error(`Unknown theme: ${themeName}`);
+        process.exit(1);
+      }
+      formatStr = theme;
+    }
     const input = await readStdin();
     const data = JSON.parse(input);
-    const output = evaluateFormat(format, data, {
+    const output = evaluateFormat(formatStr, data, {
       noEmoji: options.disableEmoji ?? false,
       noColor: options.disableColor ?? false
     });
@@ -1160,6 +1495,23 @@ Multiple style prefixes can be chained: bold:green:git:branch
       console.error(`Available themes: ${Object.keys(THEMES).join(", ")}`);
       process.exit(1);
     }
+    if (options.install) {
+      const result = install(`theme:${options.theme}`, options.project, {
+        useBunx: options.useBunx,
+        useNpx: options.useNpx,
+        globalInstall: options.globalInstall,
+        noEmoji: !options.emoji,
+        noColor: !options.color
+      });
+      if (result.success) {
+        console.log("\u2713 " + result.message);
+        console.log("\nRestart Claude Code to see your new status line!");
+      } else {
+        console.error("\u2717 " + result.message);
+        process.exit(1);
+      }
+      return;
+    }
     formatStr = theme;
   }
   if (!formatStr) {

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "claudeline",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Customizable status line generator for Claude Code",
   "type": "module",
   "bin": {
     "claudeline": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    ".claude",
+    ".claude-plugin"
   ],
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean",
@@ -19,9 +21,10 @@
     "claude-code",
     "statusline",
     "cli",
-    "terminal"
+    "terminal",
+    "claude-plugin"
   ],
-  "author": "",
+  "author": "Luca Silverentand",
   "license": "MIT",
   "devDependencies": {
     "@types/node": "^20.11.0",