@hasna/statusline 0.0.4 → 0.0.6

package/README.md

@@ -2,7 +2,7 @@
 
 Tiny, composable statusline CLI for AI coding agents. Pre-built segments you toggle
 on and off — machine name, project + branch, model, context remaining, session cost,
-and more — rendered as a single line for your agent's status bar.
+and more — rendered as one or more rows in your agent's status bar.
 
 ```
 apple03 · statusline (main) · 12h · 1.2k · fable 5 [1m] · 90% left · $0.04
@@ -14,7 +14,7 @@ Built with [Bun](https://bun.sh) + TypeScript. The CLI renderer is dependency-li
 
 ```bash
 bun install -g @hasna/statusline
-statusline install claude        # wires it into ~/.claude/settings.json
+statusline install claude        # wires it into the active Claude config dir
 ```
 
 That's it — Claude Code picks it up on the next status refresh (no restart needed).
@@ -22,7 +22,7 @@ That's it — Claude Code picks it up on the next status refresh (no restart nee
 ## Segments
 
 `statusline list` shows a compact, enabled-first summary of your segments (use
-`statusline list --all` for every row). The table below is the full catalog — all 18
+`statusline list --all` for every row). The table below is the full catalog — all 26
 segment ids from `src/segments/index.ts`.
 
 `renderLine` walks your configured segment order, renders each one, and **drops**
@@ -39,7 +39,8 @@ anything that returns `null` or throws. A failed segment never breaks the host U
 | `current-dir` | off | Current working directory (basename) | `StatusContext.cwd` | never (always renders basename) | `open-statusline` |
 | `model` | off | Current model name (no context tag) | `StatusContext.model.id` via friendly formatter | no model id | `fable 5` |
 | `model-context` | on | Model name with context-size tag | same formatter, keeps `[tag]` suffix | no model id | `fable 5 [1m]` |
-| `model-with-reasoning` | off | Model name with its reasoning effort | `model.display_name` (or friendly id) + `effort.level`; falls back to `thinking.enabled`, which the host defaults to on | no model | `Fable (xhigh)` |
+| `model-with-reasoning` | off | Model name with its reasoning effort | lowercased `model.display_name` (or friendly id) + `effort.level`; falls back to `thinking.enabled` when on | no model | `fable (xhigh)` |
+| `fast-mode` | off | Fast-mode indicator | `fastMode` in this session's Claude config-dir `settings.json` | fast mode is off or settings are unavailable | `fast` |
 | `auth-profile` | off | Account profile this session runs as | this process's `CLAUDE_CONFIG_DIR`, resolved against the accounts registry | config dir is unmanaged and has no login | `account001` |
 | `auth-email` | off | Account email this session is logged in as | the agent's own login record for this config dir, else the registry | no login recorded | `dev@example.com` |
 | `five-hour-limit` | off | Percentage of the 5-hour rate limit used | `rate_limits.five_hour.used_percentage` | host reports no limit data | `5h:42%` |
@@ -49,11 +50,12 @@ anything that returns `null` or throws. A failed segment never breaks the host U
 | `context-remaining` | on | Percentage of context window remaining | transcript via `contextUsage` | transcript missing/unreadable | `90% left` |
 | `used-tokens` | off | Total tokens in the context window | transcript usage block (input + output) | transcript missing/unreadable | `102k tok` |
 | `cost` | on | Session cost in USD | `StatusContext.cost.totalCostUsd` | cost is zero or missing | `$1,234.50` |
-| `duration` | off | Session wall-clock duration | `StatusContext.cost.totalDurationMs` | duration missing | `1h30m` |
+| `duration` | off | Session wall-clock duration | `StatusContext.cost.totalDurationMs` | duration is zero or missing | `1h30m` |
 | `lines-changed` | off | Lines added/removed this session | `cost.totalLinesAdded/Removed` | both zero | `+142/-18` |
 | `output-style` | off | Active output style | `StatusContext.outputStyle` | style is `default` or missing | `concise` |
 | `agent-version` | off | Host agent version | `StatusContext.version` | version missing | `v2.1.39` |
 | `session-id` | off | Session identifier (short) | first UUID segment of `sessionId` | no session id | `abc12345` |
+| `newline` | off | Row break | renderer starts a new output row | always (the segment emits no text itself) | line break |
 
 ### Context segments and transcripts
 
@@ -103,7 +105,7 @@ registry knows about always wins.
 ### Colours
 
 Segments may declare a colour, applied by `renderLine` when colours are on
-(the default). The rate-limit segments escalate from yellow to red past 80%.
+(the default). The rate-limit segments escalate from yellow to red at 80%.
 
 ```bash
 statusline colors off      # or set "colors": false in the config
@@ -117,7 +119,7 @@ statusline colors off      # or set "colors": false in the config
 enabled segments first, capped rows, and hints for the detail paths:
 
 ```
-Segments: 7 enabled / 18 total (showing 12 of 18)
+Segments: 7 enabled / 26 total (showing 12 of 26)
 state  default  id
 on     yes      machine
 on     yes      project
@@ -130,7 +132,7 @@ off    no       project-name
 off    no       git-branch
 off    no       current-dir
 off    no       model
-off    no       context-used
+off    no       model-with-reasoning
 Hint: use `--all` for all matching rows, `statusline show <id>` for details, `--verbose` for descriptions, `--json` for machines.
 ```
 
@@ -158,6 +160,8 @@ statusbar width.
 
 ```bash
 statusline list                          # compact segment summary
+statusline search token --json           # search ids/descriptions; list flags apply
+statusline show model-context             # show one segment in detail
 statusline enable used-tokens duration    # turn segments on (appended at the end)
 statusline disable loc                    # turn segments off
 statusline colors off                     # drop ANSI colours
@@ -165,6 +169,8 @@ statusline order machine project model-context cost   # exact order = enabled se
 statusline separator " | "                # change the separator
 statusline preview                        # render a sample line from the current dir
 statusline reset                          # back to defaults
+statusline install claude                 # update the active Claude settings file
+statusline version                        # print the package version
 ```
 
 Config lives at `~/.config/statusline/config.json` (override with `$STATUSLINE_CONFIG`):
@@ -172,6 +178,7 @@ Config lives at `~/.config/statusline/config.json` (override with `$STATUSLINE_C
 ```json
 {
   "separator": " · ",
+  "colors": true,
   "segments": ["machine", "project", "commit-age", "loc", "model-context", "context-remaining", "cost"]
 }
 ```
@@ -197,7 +204,8 @@ ids to the end; `statusline disable` removes them.
 
 Claude Code pipes a JSON payload (cwd, model, session cost, transcript path, …) to the
 configured `statusLine` command on every status refresh. `statusline render` parses it,
-renders each enabled segment, drops anything unavailable, and prints one line. Segments
+renders each enabled segment, drops anything unavailable, and prints one or more rows.
+The `newline` segment starts a new row; empty rows are removed. Segments
 that need more than the payload offers (e.g. `context-remaining`) read the session
 transcript to compute it. A segment failure is never fatal — it's simply omitted.
 
@@ -220,9 +228,10 @@ const next = enableSegments(["duration"], config).config;
 saveConfig(next);
 ```
 
-Useful exports include `parseClaudeInput`, `renderLine`, `segments`, `getSegment`,
-`defaultConfig`, `loadConfig`, `saveConfig`, `configPath`, `previewStatusline`,
-`orderSegments`, `disableSegments`, `setSeparator`, and `installClaude`.
+Useful exports include `parseClaudeInput`, `renderLine`, `renderStatusline`, `segments`,
+`getSegment`, `listSegments`, `defaultConfig`, `loadConfig`, `saveConfig`, `configPath`,
+`previewStatusline`, `enableSegments`, `disableSegments`, `orderSegments`,
+`setSeparator`, `setColors`, `installClaude`, and the account, context, format, and Git helpers.
 
 ## MCP
 
@@ -232,7 +241,7 @@ Useful exports include `parseClaudeInput`, `renderLine`, `segments`, `getSegment
 statusline-mcp
 ```
 
-It exposes safe tools for `render_statusline`, `preview_statusline`,
+It exposes safe tools for `statusline_health`, `render_statusline`, `preview_statusline`,
 `list_segments`, `get_config`, `update_config`, `enable_segments`,
 `disable_segments`, `order_segments`, and `reset_config`. Config mutation tools
 require `confirm_write: true`; every mutation tool supports `dry_run: true`.
@@ -250,8 +259,9 @@ bun install -g @hasna/statusline
 statusline install claude
 ```
 
-`installClaude()` writes to `$CLAUDE_CONFIG_DIR/settings.json`, falling back to
-`~/.claude/settings.json`. This matters for multi-account setups: when a session is
+`installClaude()` writes to `$CLAUDE_CONFIG_DIR/settings.json` when the variable is
+non-blank, falling back to `~/.claude/settings.json`. A leading `~/` in
+`CLAUDE_CONFIG_DIR` is expanded against `$HOME`. This matters for multi-account setups: when a session is
 bound to an isolated config dir, `~/.claude/settings.json` is never read, so
 installing there wires up a statusline that silently never runs.
 

package/dist/accounts.d.ts

@@ -23,9 +23,11 @@ export interface SessionAccount {
     /**
      * How `profile` was resolved. `"layout"` means it was read off the dir path
      * rather than the registry, which is authoritative about the dir but can lag
-     * a rename — see `layoutProfile`. Surfaced for diagnostics, not for display.
+     * a rename — see `layoutProfile`. `"switched"` means an in-place
+     * `switch-account` marker named another profile's account as the dir's
+     * current occupant. Surfaced for diagnostics, not for display.
      */
-    source: "registry" | "layout" | null;
+    source: "registry" | "layout" | "switched" | null;
 }
 type Env = Record<string, string | undefined>;
 /** Config dir the current process is bound to, for settings and registry lookup. */

package/dist/cli.js

@@ -243,6 +243,8 @@ var ACCOUNTS_HOME_ENV = "ACCOUNTS_HOME";
 var DEFAULT_ACCOUNTS_HOME = [".hasna", "accounts"];
 var STORE_FILE = "accounts.json";
 var PROFILES_SUBDIR = "profiles";
+var AUTH_STATE_SUBDIR = ".accounts-auth";
+var SWITCHED_ACCOUNT_MARKER_FILE = "switched-account.json";
 var STATE_FILE_PREFERRED = ".config.json";
 var STATE_FILE_PREFIX = ".claude";
 var STATE_FILE_SUFFIX = ".json";
@@ -329,6 +331,14 @@ function layoutProfile(profilesRoot, configDir, env) {
     return null;
   return { configDir, profile, tool, source: "layout" };
 }
+function switchedOccupant(configDir) {
+  const raw = readJson(join2(configDir, AUTH_STATE_SUBDIR, SWITCHED_ACCOUNT_MARKER_FILE));
+  if (!raw)
+    return null;
+  const profile = str(raw.profile);
+  const email = str(raw.email);
+  return profile || email ? { profile, email } : null;
+}
 function sessionConfigDir(env = process.env) {
   return canonical(str(env[CONFIG_DIR_ENV]) ?? join2(home(env), DEFAULT_CONFIG_SUBDIR), env);
 }
@@ -345,6 +355,16 @@ function sessionStateFile(env = process.env) {
   }
   return null;
 }
+function liveAccountEmail(env) {
+  const stateFile = sessionStateFile(env);
+  return stateFile ? str(readJson(stateFile)?.oauthAccount?.emailAddress) : null;
+}
+function occupantMatchesLiveLogin(occupant, env) {
+  const live = liveAccountEmail(env);
+  if (!live)
+    return true;
+  return occupant.email != null && occupant.email === live;
+}
 async function sessionAccount(env = process.env, tool) {
   const configDir = sessionConfigDir(env);
   const unresolved = { configDir, profile: null, tool: null, source: null };
@@ -352,21 +372,26 @@ async function sessionAccount(env = process.env, tool) {
     const paths = await accountsPaths(env);
     const entry = registryEntry(paths.store, configDir, env, tool);
     const name = str(entry?.name);
-    if (name)
-      return { configDir, profile: name, tool: str(entry?.tool), source: "registry" };
-    return layoutProfile(paths.profiles, configDir, env) ?? unresolved;
+    const owner = name ? { configDir, profile: name, tool: str(entry?.tool), source: "registry" } : layoutProfile(paths.profiles, configDir, env) ?? unresolved;
+    const occupant = switchedOccupant(configDir);
+    if (occupant && occupantMatchesLiveLogin(occupant, env))
+      return { configDir, profile: occupant.profile, tool: owner.tool, source: "switched" };
+    return owner;
   } catch {
     return unresolved;
   }
 }
 async function sessionAccountEmail(env = process.env, tool) {
   try {
-    const stateFile = sessionStateFile(env);
-    const live = stateFile ? str(readJson(stateFile)?.oauthAccount?.emailAddress) : null;
+    const live = liveAccountEmail(env);
     if (live)
       return live;
+    const configDir = sessionConfigDir(env);
+    const occupant = switchedOccupant(configDir);
+    if (occupant)
+      return occupant.email;
     const paths = await accountsPaths(env);
-    return str(registryEntry(paths.store, sessionConfigDir(env), env, tool)?.email);
+    return str(registryEntry(paths.store, configDir, env, tool)?.email);
   } catch {
     return null;
   }
@@ -694,7 +719,7 @@ async function renderLine(ctx, cfg) {
 // package.json
 var package_default = {
   name: "@hasna/statusline",
-  version: "0.0.4",
+  version: "0.0.6",
   description: "Tiny composable statusline CLI for AI coding agents \u2014 pre-built toggleable segments for Claude Code, with a provider model for others",
   license: "Apache-2.0",
   type: "module",
@@ -906,11 +931,11 @@ run \`statusline list\` to see available segments`);
   process.exitCode = 1;
 }
 function help() {
-  return `statusline ${statuslineVersion} \u2014 composable statusline for AI coding agents
+  return `statusline ${statuslineVersion} \u2014 composable status rows for AI coding agents
 
 usage:
-  statusline render              read agent JSON on stdin, print the statusline (default)
-  statusline list                compact segment list (default limit: ${DEFAULT_LIST_LIMIT})
+  statusline render              read agent JSON on stdin, print status rows (default)
+  statusline list [search text]  compact segment list (default limit: ${DEFAULT_LIST_LIMIT})
   statusline list --verbose      include descriptions
   statusline list --all          show all rows
   statusline list --json         machine-readable segment list
@@ -918,8 +943,8 @@ usage:
   statusline list --enabled      show only enabled segments
   statusline list --disabled     show only disabled segments
   statusline list --search text  filter by id or description
-  statusline search <text>       alias for list --search
-  statusline show <id>           show one segment in detail
+  statusline search <text>       alias for list --search (accepts list options)
+  statusline show <id>           show one segment in detail (--json supported)
   statusline show <id> --json    machine-readable segment detail
   statusline inspect <id>        alias for show
   statusline enable <id...>      enable segments (appended to the end)
@@ -929,7 +954,7 @@ usage:
   statusline colors <on|off>     toggle segment colours (default on)
   statusline preview             render with a sample payload from the current directory
   statusline reset               restore default config
-  statusline install [claude]    wire into Claude Code (~/.claude/settings.json)
+  statusline install [claude]    wire into the active Claude Code settings file
   statusline version             print version
 
 config: ${configPath()}`;
@@ -1200,6 +1225,8 @@ async function runCli(argv = process.argv.slice(2)) {
         return;
       }
       case "enable": {
+        if (!args.length)
+          throw new Error("usage: statusline enable <segment> [segment...]");
         let result;
         try {
           result = enableSegments(args, loadConfig());
@@ -1213,6 +1240,8 @@ order: ${result.config.segments.join(", ")}`);
         return;
       }
       case "disable": {
+        if (!args.length)
+          throw new Error("usage: statusline disable <segment> [segment...]");
         let result;
         try {
           result = disableSegments(args, loadConfig());

package/dist/index.js

@@ -242,6 +242,8 @@ var ACCOUNTS_HOME_ENV = "ACCOUNTS_HOME";
 var DEFAULT_ACCOUNTS_HOME = [".hasna", "accounts"];
 var STORE_FILE = "accounts.json";
 var PROFILES_SUBDIR = "profiles";
+var AUTH_STATE_SUBDIR = ".accounts-auth";
+var SWITCHED_ACCOUNT_MARKER_FILE = "switched-account.json";
 var STATE_FILE_PREFERRED = ".config.json";
 var STATE_FILE_PREFIX = ".claude";
 var STATE_FILE_SUFFIX = ".json";
@@ -328,6 +330,14 @@ function layoutProfile(profilesRoot, configDir, env) {
     return null;
   return { configDir, profile, tool, source: "layout" };
 }
+function switchedOccupant(configDir) {
+  const raw = readJson(join2(configDir, AUTH_STATE_SUBDIR, SWITCHED_ACCOUNT_MARKER_FILE));
+  if (!raw)
+    return null;
+  const profile = str(raw.profile);
+  const email = str(raw.email);
+  return profile || email ? { profile, email } : null;
+}
 function sessionConfigDir(env = process.env) {
   return canonical(str(env[CONFIG_DIR_ENV]) ?? join2(home(env), DEFAULT_CONFIG_SUBDIR), env);
 }
@@ -344,6 +354,16 @@ function sessionStateFile(env = process.env) {
   }
   return null;
 }
+function liveAccountEmail(env) {
+  const stateFile = sessionStateFile(env);
+  return stateFile ? str(readJson(stateFile)?.oauthAccount?.emailAddress) : null;
+}
+function occupantMatchesLiveLogin(occupant, env) {
+  const live = liveAccountEmail(env);
+  if (!live)
+    return true;
+  return occupant.email != null && occupant.email === live;
+}
 async function sessionAccount(env = process.env, tool) {
   const configDir = sessionConfigDir(env);
   const unresolved = { configDir, profile: null, tool: null, source: null };
@@ -351,21 +371,26 @@ async function sessionAccount(env = process.env, tool) {
     const paths = await accountsPaths(env);
     const entry = registryEntry(paths.store, configDir, env, tool);
     const name = str(entry?.name);
-    if (name)
-      return { configDir, profile: name, tool: str(entry?.tool), source: "registry" };
-    return layoutProfile(paths.profiles, configDir, env) ?? unresolved;
+    const owner = name ? { configDir, profile: name, tool: str(entry?.tool), source: "registry" } : layoutProfile(paths.profiles, configDir, env) ?? unresolved;
+    const occupant = switchedOccupant(configDir);
+    if (occupant && occupantMatchesLiveLogin(occupant, env))
+      return { configDir, profile: occupant.profile, tool: owner.tool, source: "switched" };
+    return owner;
   } catch {
     return unresolved;
   }
 }
 async function sessionAccountEmail(env = process.env, tool) {
   try {
-    const stateFile = sessionStateFile(env);
-    const live = stateFile ? str(readJson(stateFile)?.oauthAccount?.emailAddress) : null;
+    const live = liveAccountEmail(env);
     if (live)
       return live;
+    const configDir = sessionConfigDir(env);
+    const occupant = switchedOccupant(configDir);
+    if (occupant)
+      return occupant.email;
     const paths = await accountsPaths(env);
-    return str(registryEntry(paths.store, sessionConfigDir(env), env, tool)?.email);
+    return str(registryEntry(paths.store, configDir, env, tool)?.email);
   } catch {
     return null;
   }
@@ -693,7 +718,7 @@ async function renderLine(ctx, cfg) {
 // package.json
 var package_default = {
   name: "@hasna/statusline",
-  version: "0.0.4",
+  version: "0.0.6",
   description: "Tiny composable statusline CLI for AI coding agents \u2014 pre-built toggleable segments for Claude Code, with a provider model for others",
   license: "Apache-2.0",
   type: "module",

package/dist/mcp/index.js

@@ -243,6 +243,8 @@ var ACCOUNTS_HOME_ENV = "ACCOUNTS_HOME";
 var DEFAULT_ACCOUNTS_HOME = [".hasna", "accounts"];
 var STORE_FILE = "accounts.json";
 var PROFILES_SUBDIR = "profiles";
+var AUTH_STATE_SUBDIR = ".accounts-auth";
+var SWITCHED_ACCOUNT_MARKER_FILE = "switched-account.json";
 var STATE_FILE_PREFERRED = ".config.json";
 var STATE_FILE_PREFIX = ".claude";
 var STATE_FILE_SUFFIX = ".json";
@@ -329,6 +331,14 @@ function layoutProfile(profilesRoot, configDir, env) {
     return null;
   return { configDir, profile, tool, source: "layout" };
 }
+function switchedOccupant(configDir) {
+  const raw = readJson(join2(configDir, AUTH_STATE_SUBDIR, SWITCHED_ACCOUNT_MARKER_FILE));
+  if (!raw)
+    return null;
+  const profile = str(raw.profile);
+  const email = str(raw.email);
+  return profile || email ? { profile, email } : null;
+}
 function sessionConfigDir(env = process.env) {
   return canonical(str(env[CONFIG_DIR_ENV]) ?? join2(home(env), DEFAULT_CONFIG_SUBDIR), env);
 }
@@ -345,6 +355,16 @@ function sessionStateFile(env = process.env) {
   }
   return null;
 }
+function liveAccountEmail(env) {
+  const stateFile = sessionStateFile(env);
+  return stateFile ? str(readJson(stateFile)?.oauthAccount?.emailAddress) : null;
+}
+function occupantMatchesLiveLogin(occupant, env) {
+  const live = liveAccountEmail(env);
+  if (!live)
+    return true;
+  return occupant.email != null && occupant.email === live;
+}
 async function sessionAccount(env = process.env, tool) {
   const configDir = sessionConfigDir(env);
   const unresolved = { configDir, profile: null, tool: null, source: null };
@@ -352,21 +372,26 @@ async function sessionAccount(env = process.env, tool) {
     const paths = await accountsPaths(env);
     const entry = registryEntry(paths.store, configDir, env, tool);
     const name = str(entry?.name);
-    if (name)
-      return { configDir, profile: name, tool: str(entry?.tool), source: "registry" };
-    return layoutProfile(paths.profiles, configDir, env) ?? unresolved;
+    const owner = name ? { configDir, profile: name, tool: str(entry?.tool), source: "registry" } : layoutProfile(paths.profiles, configDir, env) ?? unresolved;
+    const occupant = switchedOccupant(configDir);
+    if (occupant && occupantMatchesLiveLogin(occupant, env))
+      return { configDir, profile: occupant.profile, tool: owner.tool, source: "switched" };
+    return owner;
   } catch {
     return unresolved;
   }
 }
 async function sessionAccountEmail(env = process.env, tool) {
   try {
-    const stateFile = sessionStateFile(env);
-    const live = stateFile ? str(readJson(stateFile)?.oauthAccount?.emailAddress) : null;
+    const live = liveAccountEmail(env);
     if (live)
       return live;
+    const configDir = sessionConfigDir(env);
+    const occupant = switchedOccupant(configDir);
+    if (occupant)
+      return occupant.email;
     const paths = await accountsPaths(env);
-    return str(registryEntry(paths.store, sessionConfigDir(env), env, tool)?.email);
+    return str(registryEntry(paths.store, configDir, env, tool)?.email);
   } catch {
     return null;
   }
@@ -694,7 +719,7 @@ async function renderLine(ctx, cfg) {
 // package.json
 var package_default = {
   name: "@hasna/statusline",
-  version: "0.0.4",
+  version: "0.0.6",
   description: "Tiny composable statusline CLI for AI coding agents \u2014 pre-built toggleable segments for Claude Code, with a provider model for others",
   license: "Apache-2.0",
   type: "module",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/statusline",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "Tiny composable statusline CLI for AI coding agents \u2014 pre-built toggleable segments for Claude Code, with a provider model for others",
   "license": "Apache-2.0",
   "type": "module",