@babarot/c-c-statusline 0.2.5 → 0.3.0

package/README.md

@@ -1,6 +1,5 @@
 # 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.
@@ -20,7 +19,7 @@ curl -fsSL https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/ins
 # npx
 npx @babarot/c-c-statusline
 
-# Deno
+# deno
 deno run -A https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/install.ts
 ```
 
@@ -33,25 +32,47 @@ Generate `~/.claude/statusline.yaml` with defaults:
 ```bash
 # 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
+Or during install:
+
+```bash
+# curl
+curl -fsSL https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/install.sh | bash -s -- --init-config
+
+# npx
+npx @babarot/c-c-statusline --init-config
+
+# deno
+deno run -A https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/install.ts --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: "?"
+theme: tokyo-night-storm
+
+# Layout: controls which items appear on each line and their order.
+# Items not listed here are hidden. Remove an item to hide it.
+lines:
+  - [model, context, git, duration, effort, vim, update]
+  - [usage]
+
+# Per-item options
+items:
+  context:
+    format: 'ctx {used}/{total} ({pct}%)'
+  git:
+    path-style: short
+    # symbols:
+    #   stash: "-"
+    #   untracked: "?"
+  vim:
+    mode: auto
+  usage:
+    bar-style: block
+    time-style: relative
 ```
 
 `settings.json` stays clean — no flags in the command:
@@ -71,8 +92,16 @@ options:
 CLI flags override config file values. Pass flags during install to bake them into `settings.json`:
 
 ```bash
+# curl
 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
+
+# npx
+npx @babarot/c-c-statusline --bar-style block --path-style short --theme tokyo-night
+
+# deno
+deno run -A https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/install.ts \
+  --bar-style block --path-style short --theme tokyo-night
 ```
 
 This writes the flags directly into the command:
@@ -87,17 +116,56 @@ This writes the flags directly into the command:
 }
 ```
 
+## Layout
+
+The `lines` config controls which items appear and in what order. Each array is a display line:
+
+```yaml
+lines:
+  - [model, context, git, duration, effort, vim, update]  # line 1
+  - [usage]                                                 # line 2+
+```
+
+**Available items:** `model`, `context`, `git`, `duration`, `effort`, `vim`, `update`, `usage`
+
+- Items are rendered left-to-right within each line, separated by `│`
+- Remove an item from `lines` to hide it
+- Reorder items to change display order
+- If `lines` is omitted, the default layout above is used
+
+Examples:
+
+```yaml
+# Minimal: only git and usage
+lines:
+  - [git, effort]
+  - [usage]
+
+# Everything on one line (no rate limit bars)
+lines:
+  - [model, context, git, duration, effort, vim, update, usage]
+
+# Custom order
+lines:
+  - [git, context, model]
+  - [usage]
+```
+
 ## 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 |
-| `vim-mode` | `auto`, `always`, `off` | `auto` | Vim mode indicator display |
-| `git-symbols` | Map or `key=val,...` | See [below](#git-symbols) | Override git status symbols |
+Options are organized per-item under the `items` section, plus a global `theme`:
+
+| Scope | Option | Values | Default | Description |
+|---|---|---|---|---|
+| global | `theme` | See [Themes](#themes) | `default` | Color theme |
+| `items.usage` | `bar-style` | `dot`, `block`, `fill` | `dot` | Progress bar style |
+| `items.usage` | `time-style` | `absolute`, `relative` | `absolute` | Reset time format |
+| `items.git` | `path-style` | `parent`, `full`, `short`, `basename` | `parent` | Directory display style |
+| `items.git` | `symbols` | Map | See [below](#git-symbols) | Override git status symbols |
+| `items.context` | `format` | Format string | `ctx {used}/{total} ({pct}%)` | Context display format |
+| `items.vim` | `mode` | `auto`, `always` | `auto` | Vim mode indicator behavior |
+
+> **Legacy support:** The flat `options` format (e.g. `options.bar-style`) still works for backward compatibility. CLI flags (e.g. `--bar-style`) also continue to work and override config file values.
 
 ### bar-style
 
@@ -143,24 +211,40 @@ Use `{used}`, `{total}`, `{pct}`, `{compact}` placeholders.
 | `--ctx-format '{pct}% compact:{compact}%'` | `14% compact:83%` |
 | `--ctx-format '{used} of {total}'` | `28k of 200k` |
 
+### model-name
+
+To hide the model name, remove `model` from `lines`:
+
+```yaml
+lines:
+  - [context, git, duration, effort, vim, update]  # no "model"
+  - [usage]
+```
+
+> Legacy: `--model-name off` and `options.model-name: "off"` still work.
+
 ### 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.
+Shows the current Vim mode when Claude Code's Vim keybinding is enabled.
 
 | Value | Behavior |
 |---|---|
 | `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).
+To hide the vim indicator entirely, remove `vim` from `lines`. To control its behavior:
 
 ```yaml
 # ~/.claude/statusline.yaml
-options:
-  vim-mode: auto
+items:
+  vim:
+    mode: auto
 ```
 
+Mode colors: `NORMAL` uses the theme's primary color, `INSERT` uses success (green).
+
+> Legacy: `--vim-mode off` and `options.vim-mode: "off"` still work.
+
 ### 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`).
@@ -201,17 +285,22 @@ Override any git status symbol. In the config file, use a map; with CLI flags, u
 
 Config file:
 ```yaml
-options:
-  git-symbols:
-    stash: "-"
-    untracked: "?"
+items:
+  git:
+    symbols:
+      stash: "-"
+      untracked: "?"
 ```
 
+> Legacy: `options.git-symbols` also still works.
+
 ## What it shows
 
-**Line 1:** Model name, context usage (tokens + %), directory, git status, session duration, effort level
+**Line 1** (default): Model name, context usage (tokens + %), directory, git status, session duration, effort level, vim mode, update notification
+
+**Lines 2+** (default): Rate limit usage (current 5-hour window, weekly, extra credits when active)
 
-**Lines 2+:** Rate limit usage (current 5-hour window, weekly, extra credits when active)
+All items can be reordered, shown, or hidden via the [`lines` config](#layout).
 
 ### Git status
 
@@ -247,7 +336,7 @@ curl -fsSL https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/ins
 # npx
 npx @babarot/c-c-statusline --uninstall
 
-# Deno
+# deno
 deno run -A https://raw.githubusercontent.com/babarot/c-c-statusline/main/bin/install.ts --uninstall
 ```
 

package/bin/install.js

@@ -261,6 +261,7 @@ if (argv.includes("--help") || argv.includes("-h")) {
     --time-style <absolute|relative>          Time format (default: absolute)
     --ctx-format <format>                     Context display format
     --vim-mode <auto|always|off>              Vim mode display (default: auto)
+    --model-name <on|off>                     Model name display (default: on)
     --git-symbols <key=val,...>               Override git symbols
     --init-config                             Generate ~/.claude/statusline.yaml
     --uninstall                               Remove statusline
@@ -274,7 +275,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", "--vim-mode", "--git-symbols"];
+  const valueFlags = ["--bar-style", "--path-style", "--theme", "--time-style", "--ctx-format", "--vim-mode", "--model-name", "--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.5",
+  "version": "0.3.0",
   "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"