[tough-griff]

Closes #600

Adds a per-widget label override for widgets that show a text label (Model: , Ctx: , In: , …). Select the widget in the line editor and press b (la(b)el…).

Changes

• Storage: the override is saved as metadata.label and used exactly as typed. An empty string removes the label. A value equal to the current default is still stored, so it applies in every mode (see below). Changing a widget's type drops its label. No schema change or migration.
• Rendering: formatRawOrLabeledValue now uses the override, so every widget that already went through it gets the feature from one change. Each widget's render takes its default from its own getLabelPrefix(item), so the label the editor offers and the one rendered can't drift apart. Widgets that built their label inline now use the helper too: Model, Session ID, Account Email, Context Length/Window/Bar, Memory Usage, Output Style, Session Clock/Name/Cost, Thinking Effort, Terminal Width, Git Staged/Unstaged/Untracked Files, and Current Working Dir (its optional glyph still comes before the label).
• Opt-in: widgets declare a new optional Widget.getLabelPrefix(item), which returns their default label for the item's current mode (Context % gives Ctx Used: or Ctx Left: ; Block, Block Reset and Weekly Reset timers give Block , Reset and Weekly Reset in their bar modes). The usage and speed families get theirs from their shared config.
• One override for every mode: widgets with more than one label variant (Block: vs Block before a bar) use the same override in all modes, even one that matches the current mode's default (e.g. Block set in a bar mode also drops the colon in time mode).
• TUI:
  • The keybind is added centrally in ItemsEditor, the same way (h)ide… is, and is hidden while raw value is on.
  • It opens a new LabelEditor. The value is shown in quotes so trailing spaces are visible. Enter saves the typed label and Tab clears the override back to the default.
  • Rows show (label: "M ") while an override is set. The label is JSON-escaped there and in the editor's default, so a " inside it reads clearly.
  • l would be the natural key, but the reset timers already use it for (l)ocale.
• Shared text cursor: CustomText's grapheme-aware cursor code is moved into useTextCursor (src/widgets/shared/text-cursor.ts), which the label editor and Custom Text now both use. This also makes Ctrl+←/→ jump to the start/end as Custom Text's hint says. The old checks compared input to 'ArrowLeft', which Ink never sends, and ran after the plain-arrow branch, so they never matched. Edits apply through a functional state update so keys typed before a re-render aren't lost, and the cursor ends with \x1b[27m (inverse off) rather than a full reset. getGraphemes is exported and replaces the copies in Custom Symbol and the symbol override editor.
• Out of scope: glyph widgets keep (g)lyph. Widgets whose prefix is really part of the value (Version, Git PR, Sandbox/Voice/Remote Control status, Git Is Fork, Link) aren't changed.
• Behavior change: the reset timers' loading placeholder follows the bar-mode label, so in progress/slider modes it reads Reset [Loading] / Weekly Reset [Loading] instead of Reset: [Loading].
• Docs: docs/USAGE.md covers the keybind in the raw value section and in the editor keybind list.

Testing

• Unit tests for the label helper and the text cursor (grapheme movement/deletion with emoji, edges, Ctrl jumps, cursor rendering)
• Override cases for Model and Session Usage (text and slider modes), plus Context %'s mode-dependent default
• A registry-wide test that every label widget's preview render, in every display mode, contains its getLabelPrefix(item)
• Bar-mode loading cases for the Block Reset and Weekly Reset timers
• A registry-wide test that no label widget binds b itself in any mode, next to the existing h check
• An end-to-end ItemsEditor test covering b → edit → save → (label: "M "), with the keybind and row tag hidden in raw value mode. Further editor tests cover: a type change dropping the label; two keys typed before a re-render both landing; a joined-emoji label shown whole beside its default; and a bar-mode Block label being saved, then cleared with Tab
• bun test and bun run lint pass
• Manually checked in the TUI and with piped input:

$ echo '{"model":{"id":"claude-sonnet-4-5","display_name":"Sonnet 4.5"}}' | bun run src/ccstatusline.ts --config settings.json
M Sonnet 4.5 | Model: Sonnet 4.5 | 80

settings.json

{
  "version": 4,
  "lines": [
    [
      { "id": "1", "type": "model", "metadata": { "label": "M " } },
      { "id": "2", "type": "separator" },
      { "id": "3", "type": "model" },
      { "id": "4", "type": "separator" },
      { "id": "5", "type": "terminal-width", "metadata": { "label": "" } }
    ]
  ]
}

🤖 Generated with Claude Code

[eric-engberg]

Thanks for this one. It's a feature I've wanted, and opting widgets in with getLabelPrefix keeps it tidy. I tried it and read through it, and ran into a few things:

1. Timer widgets in their bar modes. Block Timer, Block Reset Timer and Weekly Reset Timer render Block (no colon) before a bar, but getLabelPrefix() always returns Block: . In a bar mode the editor offers Block: as the default. Typing Block: there is then dropped by setLabel as equal to the default, so the bar keeps Block . The same goes for Reset and Weekly Reset . Returning the bar-mode label from getLabelPrefix(item) in those modes, as Context % does for its two labels, would line them up.

2. Changing a widget's type keeps the label. Changing the type with → keeps the item's metadata, and nearly every labeled widget now reads metadata.label. So a label set on Model (M ) shows up on Session Cost after a type change (M $2.45). If the new type has no label, the old one stays hidden with no b to clear it, and comes back on the next type change. Dropping label when the type changes would avoid that.

3. One source for the default label. Each widget states its label in getLabelPrefix() and again as the literal it passes to formatRawOrLabeledValue, which is how the timer mismatch slipped in. If render took its label from this.getLabelPrefix(item), the two couldn't drift.

4. useTextCursor and fast input. handleInput works from the state captured at render and calls setState(next). Two keys handled before a re-render apply to the same snapshot, and one is lost. A functional update, setState(prev => applyTextCursorInput(prev, input, key) ?? prev), avoids it. Custom Text's old code had the same pattern, so this isn't new, but the shared hook is a good place to fix it.

Smaller things:

• LabelEditor puts the label and (default: …) in two sibling Texts. Ink lays out each code point of a toned or joined emoji (👍🏾, 👩‍💻) as its own character, so the second Text overwrites the end of such a label on screen; the saved value is fine. Nesting both in one Text avoids it.
• getGraphemes in text-cursor.ts is private, so the same Intl.Segmenter code is still in CustomSymbol.tsx and shared/symbol-override.tsx. Exporting it would leave one copy.
• renderTextWithCursor splits the text twice and builds a new segmenter each call. One module-level segmenter and a single split would do.
• (label: "…") and the editor wrap the label in quotes without escaping it, so a label containing " reads ambiguously. JSON.stringify(label) would keep it clear.
• After the cursor, \x1b[0m resets every attribute; \x1b[27m would end just the inverse.

[tough-griff]

@eric-engberg thanks for the review! My tweaks worked at first pass for me and I admittedly didn't do much more thorough testing. I've addressed the feedback, PR description is updated accordingly.