Skip to content

t1k:statusline-full

FieldValue
Modulet1k-base
Version5.15.36
Effortlow
Tools—

Keywords: 5h timer, context bar, full statusline, global statusline, install statusline globally, status line, statusline, weekly quota

/t1k:statusline-full
[--from <.claude/hooks dir>]

t1k:statusline-full — Global statusline installer

Section titled “t1k:statusline-full — Global statusline installer”

Promotes the kit’s canonical statusline (.claude/hooks/statusline.cjs) to a global install under ~/.claude/ so it renders in every Claude Code session — including projects that aren’t TheOneKit kits.

This skill does not carry its own copy of the statusline. It sources the kit’s own hooks/statusline.cjs + hooks/lib/* — single source of truth, no fork drift.

  • “Enable the full statusline globally”, “install statusline to ~/.claude”, “show the statusline in every project”.
  • NOT needed inside a t1k project — there the kit already wires the statusline per-project via statusline.cjs (older installs: hook-runner.cjs statusline). This skill is for the global case.

Glyphs below are the Unicode fallback — with a Nerd Font installed each icon is replaced by its Nerd Font equivalent, see Icons below.

Left side, top to bottom:

  • Line 1: 🤖 model <effort> [▰▰▰▱▱…] N% context
  • Line 2: 📁 dir 🌿 branch (status) 📝 +added -removed
  • Line 3: 🌐 model-router v<ver> (<state>)
  • Line 4+: current todo, Plane workload (opt-in), routing run-state

Right-anchored block — 👤 email, ⌛ rolling 5h, 📅 weekly 7d, 🟣 Fable. Identity and quota, pinned to the right edge so a long branch or directory never slides them:

  • Wide terminal: one item per row, right-aligned on the last column the statusline can actually use — the width the harness reports (COLUMNS) minus the 4 columns the host reserves (2 of left indent, 2 unused on the right; measured on a live pane: host borders 145 cells, statusline rows 143). Padding to the full reported width makes the host truncate the anchored items (marketing@the1studio.…) and wrap a padding-only row — which parks 🟣 Fable 0% at column 0. Override with T1K_STATUSLINE_INDENT=<n> if your client reserves a different amount; no statusline payload reports it.
  • Narrow terminal: the block collapses to one bottom row, ·-separated — someone@example.com · 24% · 2h0m · 5% · 5d18h. All three quota segments render dim, so none reads as a more important kind of value. Items drop from the end (Fable first, then weekly) until the row fits. The rolling and weekly windows are the limits a session can actually run out of, so they outrank the model-scoped sub-limit.

Both quota windows read xx% · time — percent first, same order in the left and right shapes, so the two are never misread as each other.

Usage data comes from Claude Code’s native statusline stdin (rate_limits, CC ≥ 2.1.80), with a fallback to os.tmpdir()/ck-usage-limits-cache.json. No separate usage hook is required — the canonical statusline is self-sufficient.

Run from inside a TheOneKit project (so the kit’s hooks/statusline.cjs is present):

Terminal window
bash .claude/skills/t1k-statusline-full/install.sh

Or point at any kit’s hooks directory explicitly:

Terminal window
bash .claude/skills/t1k-statusline-full/install.sh --from /path/to/.claude/hooks

It copies statusline.cjs → ~/.claude/statusline.cjs, the full dependency closure of statusline.cjs → ~/.claude/lib/, and wires ~/.claude/settings.json:

{ "statusLine": { "type": "command", "command": "node \"$HOME/.claude/statusline.cjs\"", "padding": 0 } }

The closure is computed at install time by walking require('./...') from statusline.cjs through hooks/lib/ — the script’s LIBS= line is the declaration it is checked against, not the copy set. If the two disagree the installer exits 1 and names the drift rather than installing a statusline that dies MODULE_NOT_FOUND on first render. So adding a lib to the closure means adding it to LIBS= in install.sh in the same change; the count is deliberately not restated here (it went stale four times: #52, #2174, #751, #2263).

Restart Claude Code to pick it up.

The statusline reads T1K_STATUSLINE_MODE (default full): full | compact | minimal. Export the env var in your shell/profile to change it globally.

Each segment’s glyph is a Nerd Font icon when one is installed, and the plain Unicode emoji otherwise — same layout, same widths, just the characters that your terminal can actually draw: 🤖 model → model, 📁 dir → dir, 🌿 branch → branch, and so on. The ▰▱ context bar, the ●○ agent dots, and the ↑↓ git arrows are geometric shapes every terminal font already carries, so they never change.

Detection order (see hooks/lib/statusline-icons.cjs):

  1. T1K_NERD_FONT=1|0 — explicit, always wins in both directions.
  2. TERM_PROGRAM — WezTerm and Ghostty bundle a Nerd Font, so their users have the glyphs without anything in a font directory.
  3. A bounded scan of the platform font directories for a *nerd*font* filename.

Set T1K_NERD_FONT=0 if a detected font is not what your terminal actually renders (e.g. the Nerd Font is installed but the terminal is configured with a different family) — that is the one case detection cannot see.

The right-anchored block (email + quotas) lays itself out against the terminal width reported on stderr, then $COLUMNS, then a 120-column fallback (see getTerminalWidth() in hooks/statusline.cjs). That width decides both where the anchor lands and whether the block renders as a column or as one collapsed row, so a harness that never reports a width will get a block laid out for the 120-column fallback rather than for the pane. Set COLUMNS in the environment if yours is one.

  • Writes only under ~/.claude/ (statusline.cjs, lib/*.cjs, settings.json). It does not touch any project’s .claude/ or the kit’s per-project wiring.
  • Reads the session JSON Claude Code pipes on stdin and local claude auth status metadata to render; it does not transmit anything off-machine. Per-session auth and context caches are owner-only on POSIX and expire after 7 days.
  • Re-running is idempotent: it overwrites the installed statusline files with the current canonical versions and re-wires statusLine.

Runs in t1k-hooks-manager (or inline). A single deterministic installer; no judgment step.

StepAgent
Run install.sh (copy statusline.cjs and its lib closure, wire statusLine)t1k-hooks-manager