@babarot/c-c-statusline 0.2.3 → 0.2.5

package/README.md

@@ -1,10 +1,13 @@
 # c-c-statusline
 
+
+[![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.
 
-![screenshot](ss.png)
+![screenshot](docs/demo-r.png)
 
 ## Install
 
@@ -39,6 +42,7 @@ curl -fsSL https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/ins
 Then edit to your liking:
 
 ```yaml
+# ~/.claude/statusline.yaml
 options:
   bar-style: block
   path-style: short
@@ -50,16 +54,39 @@ options:
     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. Useful for quick testing or one-off overrides.
+CLI flags override config file values. Pass flags during install to bake them into `settings.json`:
 
 ```bash
-# Pass flags during install to set defaults in settings.json
 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 |
@@ -69,33 +96,34 @@ curl -fsSL https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/ins
 | `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
 
-| Value | Output |
+| Input | Output |
 |---|---|
-| `dot` | `●●●●○○○○○○` |
-| `block` | `▰▰▰▰▱▱▱▱▱▱` |
-| `fill` | `████░░░░░░` |
+| `--bar-style dot` | `●●●●○○○○○○` |
+| `--bar-style block` | `▰▰▰▰▱▱▱▱▱▱` |
+| `--bar-style fill` | `████░░░░░░` |
 
 ### path-style
 
 For `/Users/you/src/github.com/you/project`:
 
-| Value | Output |
+| Input | Output |
 |---|---|
-| `parent` | `you/project` |
-| `full` | `~/src/github.com/you/project` |
-| `short` | `~/s/g/you/project` |
-| `basename` | `project` |
+| `--path-style parent` | `you/project` |
+| `--path-style full` | `~/src/github.com/you/project` |
+| `--path-style short` | `~/s/g/you/project` |
+| `--path-style basename` | `project` |
 
 ### time-style
 
-| Value | Output |
+| Input | Output |
 |---|---|
-| `absolute` | `8:00pm`, `Mar 12, 2:00pm` |
-| `relative` | `1h 30m left`, `2d 5h left` |
+| `--time-style absolute` | `8:00pm`, `Mar 12, 2:00pm` |
+| `--time-style relative` | `1h 30m left`, `2d 5h left` |
 
 ### ctx-format
 
@@ -108,12 +136,30 @@ Use `{used}`, `{total}`, `{pct}`, `{compact}` placeholders.
 | `{pct}` | Usage percentage (e.g. `14`) |
 | `{compact}` | Remaining % until auto-compact (based on 80% usable threshold) |
 
-| Value | Output |
+| Input | Output |
+|---|---|
+| `--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` |
+
+### vim-mode
+
+Shows the current Vim mode when Claude Code's Vim keybinding is enabled. The indicator is appended to the end of line 1.
+
+| Value | Behavior |
 |---|---|
-| `ctx {used}/{total} ({pct}%)` | `ctx 28k/200k (14%)` |
-| `{pct}% ({used}/{total})` | `14% (28k/200k)` |
-| `{pct}% compact:{compact}%` | `14% compact:83%` |
-| `{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
 
@@ -148,6 +194,11 @@ Override any git status symbol. In the config file, use a map; with CLI flags, u
 | `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:
@@ -156,11 +207,6 @@ options:
     untracked: "?"
 ```
 
-CLI flag:
-```bash
---git-symbols "stash=-,untracked=?"
-```
-
 ## What it shows
 
 **Line 1:** Model name, context usage (tokens + %), directory, git status, session duration, effort level

package/bin/install.js

@@ -260,6 +260,7 @@ if (argv.includes("--help") || argv.includes("-h")) {
     --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
@@ -273,7 +274,7 @@ if (argv.includes("--uninstall")) {
 } else {
   const extraArgs = [];
   const initConfig = argv.includes("--init-config");
-  const valueFlags = ["--bar-style", "--path-style", "--theme", "--time-style", "--ctx-format", "--git-symbols"];
+  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] === "--init-config") continue;
     if (valueFlags.includes(argv[i]) && argv[i + 1]) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babarot/c-c-statusline",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "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"