t1k:statusline-full
| Field | Value |
|---|---|
| Module | t1k-base |
| Version | 5.15.36 |
| Effort | low |
| Tools | — |
Keywords: 5h timer, context bar, full statusline, global statusline, install statusline globally, status line, statusline, weekly quota
How to invoke
Section titled “How to invoke”/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.
When to use
Section titled “When to use”- “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.
What it renders
Section titled “What it renders”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 withT1K_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.
Install
Section titled “Install”Run from inside a TheOneKit project (so the kit’s hooks/statusline.cjs is present):
bash .claude/skills/t1k-statusline-full/install.shOr point at any kit’s hooks directory explicitly:
bash .claude/skills/t1k-statusline-full/install.sh --from /path/to/.claude/hooksIt 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):
T1K_NERD_FONT=1|0— explicit, always wins in both directions.TERM_PROGRAM— WezTerm and Ghostty bundle a Nerd Font, so their users have the glyphs without anything in a font directory.- 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.
Layout
Section titled “Layout”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.
Scope & safety
Section titled “Scope & safety”- 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 statusmetadata 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.
Executed by
Section titled “Executed by”Runs in t1k-hooks-manager (or inline). A single deterministic installer; no judgment step.
| Step | Agent |
|---|---|
Run install.sh (copy statusline.cjs and its lib closure, wire statusLine) | t1k-hooks-manager |