skills.rest
alvis
alvisCOMMUNITY
Explore all skills by this author →
Website𝕏@alvishttangGitHub

install-statusline

Installs the bundled Bullet Train statusline into ~/.claude and wires settings.json.

4|1|Updated Jul 31, 2025
Search Tags:#claude code#bash#terminal#statusline#jq#settings.json#install
One-click install
npx skills add https://github.com/alvis/.agents --skill install-statusline-alvis
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: install-statusline
Source: https://github.com/alvis/.agents/tree/main/plugins/essential/skills/install-statusline
Command: npx skills add https://github.com/alvis/.agents --skill install-statusline-alvis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) components.

What problem does it solve? Setting up a Claude Code statusline on a new machine requires manually copying scripts, setting executable permissions, and editing settings.json, which is error-prone and tedious to repeat across machines. ## Core Features & Use Cases - Idempotent installer: Copies the bundled statusline binary to ~/.claude/bin, marks it executable, and safely re-runs without duplicating work. - Atomic settings wiring: Updates the statusLine key in ~/.claude/settings.json with a timestamped backup taken only when the value actually changes. - Built-in smoke test: Pipes a fixture JSON through the installed binary to confirm it renders a non-empty statusline before finishing. - Use Case: After provisioning a new laptop, run the installer once to restore your full statusline showing branch state, model, context percentage, and rate-limit bars, with legacy scripts retired to /tmp. ## Quick Start Install the bundled statusline on this machine and wire it into my Claude Code settings.

Frequently Asked Questions about install-statusline

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install a custom statusline in Claude Code?▼

Run the bundled install-statusline.sh script, which copies the statusline binary to ~/.claude/bin/statusline, marks it executable, and sets the statusLine key in ~/.claude/settings.json. The script is idempotent and safe to re-run.

How do I configure the statusLine setting in Claude Code settings.json?▼

Set statusLine to {"type": "command", "command": "~/.claude/bin/statusline"} in ~/.claude/settings.json. The installer does this automatically with an atomic write and creates a timestamped backup only when the value actually changes.

What does the Claude Code statusline display?▼

It renders time, branch with jj/git state markers, repo-relative path, model name, context window percentage with token counts, 5-hour and 7-day rate-limit braille bars, and the active output style. In jj-colocated repos it reads @ metadata with --ignore-working-copy.

Why does the statusline installer fail with a jq error?▼

The installer requires jq on PATH to read and update settings.json, and it aborts with an install hint when jq is missing. Install it with brew install jq on macOS, then re-run the installer.

Can I change what the statusline renders through the installer?▼

No. The installer only copies and wires the bundled statusline; changing what it renders is a source change to the bundled scripts/statusline file, not an install task.

Related Skills

Explore More Software Engineering Skills→
jcwleojcwleo
10

install-statusline

Install a developer statusline and subagent monitor into Claude Code configuration.

Community
Intermediate
sd0xdevsd0xdev
189

statusline-config

Generates and customizes the Claude Code statusline shell script with segments and color themes.

Community
Intermediate
Yeachan-HeoYeachan-Heo
38.5k

hud

Configure Claude Code HUD display options and automate wrapper setup.

Community
Intermediate
sehoon787sehoon787
16

hud

Configure and automate the HUD statusline display in Claude Code.

Community
Intermediate