@babarot/c-c-statusline 0.2.2 → 0.2.4

package/README.md

@@ -1,78 +1,169 @@
 # c-c-statusline
 
-A Deno-powered status line for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI.
+
+[![Test](https://github.com/babarot/c-c-statusline/actions/workflows/test.yml/badge.svg)](https://github.com/babarot/c-c-statusline/actions/workflows/test.yml)
+
+A Deno-powered status line for Claude Code CLI.
 
 Shows model info, context usage, rate limits, git status, session duration, and more — right in your terminal.
 
-## Install
+![screenshot](docs/demo-r.png)
 
-### Binary (recommended)
+## Install
 
 Downloads a precompiled binary from GitHub Releases. No runtime dependencies needed.
 
 ```bash
-# Deno
-deno run -A https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/install.ts
+# curl
+curl -fsSL https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/install.sh | bash
 
 # npx
 npx @babarot/c-c-statusline
+
+# Deno
+deno run -A https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/install.ts
 ```
 
-### Options
+## Configure
 
-Pass options during install to customize the statusline:
+### Config file (recommended)
+
+Generate `~/.claude/statusline.yaml` with defaults:
 
 ```bash
-deno run -A https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/install.ts \
-  --bar-style block --path-style short --theme tokyo-night
+# After install
+~/.claude/c-c-statusline --init-config
+
+# Or during install
+curl -fsSL https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/install.sh \
+  | bash -s -- --init-config
+```
+
+Then edit to your liking:
+
+```yaml
+# ~/.claude/statusline.yaml
+options:
+  bar-style: block
+  path-style: short
+  theme: tokyo-night-storm
+  time-style: relative
+  ctx-format: 'ctx {used}/{total} ({pct}%)'
+  git-symbols:
+    stash: "-"
+    untracked: "?"
+```
+
+`settings.json` stays clean — no flags in the command:
+
+```jsonc
+// ~/.claude/settings.json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "\"$HOME/.claude/c-c-statusline\""
+  }
+}
+```
+
+### CLI flags
+
+CLI flags override config file values. Pass flags during install to bake them into `settings.json`:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/install.sh \
+  | bash -s -- --bar-style block --path-style short --theme tokyo-night
+```
+
+This writes the flags directly into the command:
+
+```jsonc
+// ~/.claude/settings.json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "\"$HOME/.claude/c-c-statusline\" --bar-style block --path-style short --theme tokyo-night"
+  }
+}
 ```
 
+## Options
+
 | Option | Values | Default | Description |
 |---|---|---|---|
-| `--bar-style` | `dot`, `block`, `fill` | `dot` | Progress bar style |
-| `--path-style` | `parent`, `full`, `short`, `basename` | `parent` | Directory display style |
-| `--theme` | See [Themes](#themes) | `default` | Color theme |
-| `--time-style` | `absolute`, `relative` | `absolute` | Reset time format |
-| `--ctx-format` | Format string | `ctx {used}/{total} ({pct}%)` | Context display format |
+| `bar-style` | `dot`, `block`, `fill` | `dot` | Progress bar style |
+| `path-style` | `parent`, `full`, `short`, `basename` | `parent` | Directory display style |
+| `theme` | See [Themes](#themes) | `default` | Color theme |
+| `time-style` | `absolute`, `relative` | `absolute` | Reset time format |
+| `ctx-format` | Format string | `ctx {used}/{total} ({pct}%)` | Context display format |
+| `vim-mode` | `auto`, `always`, `off` | `auto` | Vim mode indicator display |
+| `git-symbols` | Map or `key=val,...` | See [below](#git-symbols) | Override git status symbols |
+
+### bar-style
+
+| Input | Output |
+|---|---|
+| `--bar-style dot` | `●●●●○○○○○○` |
+| `--bar-style block` | `▰▰▰▰▱▱▱▱▱▱` |
+| `--bar-style fill` | `████░░░░░░` |
+
+### path-style
 
-**Bar styles:**
+For `/Users/you/src/github.com/you/project`:
 
-| Style | Example |
+| Input | Output |
 |---|---|
-| `dot` | `●●●●○○○○○○` |
-| `block` | `▰▰▰▰▱▱▱▱▱▱` |
-| `fill` | `████░░░░░░` |
+| `--path-style parent` | `you/project` |
+| `--path-style full` | `~/src/github.com/you/project` |
+| `--path-style short` | `~/s/g/you/project` |
+| `--path-style basename` | `project` |
 
-**Path styles** (for `/Users/you/src/github.com/you/project`):
+### time-style
 
-| Style | Example |
+| Input | Output |
 |---|---|
-| `parent` | `you/project` |
-| `full` | `~/src/github.com/you/project` |
-| `short` | `~/s/g/you/project` |
-| `basename` | `project` |
+| `--time-style absolute` | `8:00pm`, `Mar 12, 2:00pm` |
+| `--time-style relative` | `1h 30m left`, `2d 5h left` |
 
-**Time styles:**
+### ctx-format
 
-| Style | Example |
+Use `{used}`, `{total}`, `{pct}`, `{compact}` placeholders.
+
+| Placeholder | Description |
+|---|---|
+| `{used}` | Tokens used (e.g. `28k`) |
+| `{total}` | Context window size (e.g. `200k`) |
+| `{pct}` | Usage percentage (e.g. `14`) |
+| `{compact}` | Remaining % until auto-compact (based on 80% usable threshold) |
+
+| Input | Output |
 |---|---|
-| `absolute` | `8:00pm`, `Mar 12, 2:00pm` |
-| `relative` | `1h 30m left`, `2d 5h left` |
+| `--ctx-format 'ctx {used}/{total} ({pct}%)'` | `ctx 28k/200k (14%)` |
+| `--ctx-format '{pct}% ({used}/{total})'` | `14% (28k/200k)` |
+| `--ctx-format '{pct}% compact:{compact}%'` | `14% compact:83%` |
+| `--ctx-format '{used} of {total}'` | `28k of 200k` |
 
-**Context format** (`--ctx-format`):
+### vim-mode
 
-Use `{used}`, `{total}`, `{pct}` placeholders to build any format.
+Shows the current Vim mode when Claude Code's Vim keybinding is enabled. The indicator is appended to the end of line 1.
 
-| Format string | Example |
+| Value | Behavior |
 |---|---|
-| `ctx {used}/{total} ({pct}%)` | `ctx 28k/200k (14%)` |
-| `{pct}% ({used}/{total})` | `14% (28k/200k)` |
-| `{pct}%` | `14%` |
-| `{used} of {total}` | `28k of 200k` |
+| `auto` | Show only in `NORMAL` mode (hides in `INSERT` to reduce noise) |
+| `always` | Show in all modes (`NORMAL`, `INSERT`, etc.) |
+| `off` | Never show |
+
+Mode colors: `NORMAL` uses the theme's primary color, `INSERT` uses success (green).
+
+```yaml
+# ~/.claude/statusline.yaml
+options:
+  vim-mode: auto
+```
 
 ### Themes
 
-Built-in color themes using 24-bit True Color (RGB). Each theme defines 8 semantic color roles (`primary`, `secondary`, `success`, `warning`, `caution`, `danger`, `muted`, `accent`), so every theme can map any color to any role.
+Built-in color themes using 24-bit True Color (RGB). Each theme defines 8 semantic color roles (`primary`, `secondary`, `success`, `warning`, `caution`, `danger`, `muted`, `accent`).
 
 | Theme | Description |
 |---|---|
@@ -90,6 +181,32 @@ Built-in color themes using 24-bit True Color (RGB). Each theme defines 8 semant
 | `kanagawa` | [Kanagawa](https://github.com/rebelot/kanagawa.nvim) |
 | `rose-pine` | [Rosé Pine](https://rosepinetheme.com/) |
 
+### Git symbols
+
+Override any git status symbol. In the config file, use a map; with CLI flags, use `key=val,...` format.
+
+| Key | Default | Description |
+|---|---|---|
+| `unstaged` | `*` | Unstaged changes |
+| `staged` | `+` | Staged changes |
+| `stash` | `$` | Stash entries exist |
+| `untracked` | `%` | Untracked files |
+| `ahead` | `↑` | Ahead of upstream |
+| `behind` | `↓` | Behind upstream |
+
+| Input | Output |
+|---|---|
+| `--git-symbols "stash=-,untracked=?"` | `(main *+ -?)` |
+| `--git-symbols "unstaged=~,staged=+,stash=-,untracked=?,ahead=+,behind=-"` | `(main ~+ -? +1-2)` |
+
+Config file:
+```yaml
+options:
+  git-symbols:
+    stash: "-"
+    untracked: "?"
+```
+
 ## What it shows
 
 **Line 1:** Model name, context usage (tokens + %), directory, git status, session duration, effort level
@@ -124,11 +241,14 @@ Detached HEAD is shown in red with a tag or short SHA.
 ## Uninstall
 
 ```bash
-# Deno
-deno run -A https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/install.ts --uninstall
+# curl
+curl -fsSL https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/install.sh | bash -s -- --uninstall
 
 # npx
 npx @babarot/c-c-statusline --uninstall
+
+# Deno
+deno run -A https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/install.ts --uninstall
 ```
 
 ## License

package/bin/install.js

@@ -147,7 +147,7 @@ async function uninstall() {
   console.log();
 }
 
-async function install(extraArgs) {
+async function install(extraArgs, initConfig) {
   console.log();
   console.log(`  ${blue}Claude Code Statusline Installer${reset}`);
   console.log(`  ${dim}────────────────────────────────${reset}`);
@@ -219,6 +219,21 @@ async function install(extraArgs) {
     success(`Updated ${dim}settings.json${reset}`);
   }
 
+  if (initConfig) {
+    const configPath = path.join(CLAUDE_DIR, "statusline.yaml");
+    if (fs.existsSync(configPath)) {
+      warn(`Config already exists: ${dim}${configPath}${reset}`);
+    } else {
+      const { execFileSync } = require("child_process");
+      try {
+        execFileSync(BINARY_DEST, ["--init-config"], { stdio: "inherit" });
+        success(`Generated ${dim}${configPath}${reset}`);
+      } catch {
+        warn("Failed to generate config file");
+      }
+    }
+  }
+
   console.log();
   log(`${green}Done!${reset} Restart Claude Code to see your new status line.`);
   if (extraArgs.length > 0) {
@@ -242,6 +257,12 @@ if (argv.includes("--help") || argv.includes("-h")) {
   ${dim}Options:${reset}
     --bar-style <dot|block|fill>              Bar style (default: dot)
     --path-style <parent|full|short|basename> Path style (default: parent)
+    --theme <name>                            Color theme (default: default)
+    --time-style <absolute|relative>          Time format (default: absolute)
+    --ctx-format <format>                     Context display format
+    --vim-mode <auto|always|off>              Vim mode display (default: auto)
+    --git-symbols <key=val,...>               Override git symbols
+    --init-config                             Generate ~/.claude/statusline.yaml
     --uninstall                               Remove statusline
     --help                                    Show this help
 `);
@@ -252,12 +273,16 @@ if (argv.includes("--uninstall")) {
   uninstall();
 } else {
   const extraArgs = [];
+  const initConfig = argv.includes("--init-config");
+  const valueFlags = ["--bar-style", "--path-style", "--theme", "--time-style", "--ctx-format", "--vim-mode", "--git-symbols"];
   for (let i = 0; i < argv.length; i++) {
-    if (argv[i] === "--bar-style" && argv[i + 1]) {
-      extraArgs.push("--bar-style", argv[++i]);
-    } else if (argv[i] === "--path-style" && argv[i + 1]) {
-      extraArgs.push("--path-style", argv[++i]);
+    if (argv[i] === "--init-config") continue;
+    if (valueFlags.includes(argv[i]) && argv[i + 1]) {
+      extraArgs.push(argv[i], argv[++i]);
+    } else {
+      fail(`Unknown option: ${argv[i]}`);
+      process.exit(1);
     }
   }
-  install(extraArgs);
+  install(extraArgs, initConfig);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babarot/c-c-statusline",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "A Deno-powered status line for Claude Code CLI showing model, context usage, rate limits, and more",
   "bin": {
     "c-c-statusline": "./bin/install.js"