skills.rest
psw7205
psw7205COMMUNITY
Explore all skills by this author →
WebsiteGitHub

statusline

Installs a two-line Claude Code statusline script showing git branch, model, context usage, and rate limits.

1|Updated Mar 18, 2026
Search Tags:#claude code#terminal#shell script#statusline#rate limit#git branch#context usage
One-click install
npx skills add https://github.com/psw7205/skills --skill statusline-psw7205
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: statusline
Source: https://github.com/psw7205/skills/tree/main/skills/statusline
Command: npx skills add https://github.com/psw7205/skills --skill statusline-psw7205

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq.

What problem does it solve? Claude Code's terminal gives no persistent visibility into which directory, git branch, model, context usage, or rate limit you are operating under, forcing you to run manual commands to check session state. ## Core Features & Use Cases - Two-line status display: Line 1 shows directory name, git branch (with detached HEAD fallback), worktree name, and model name; line 2 shows context percentage, rate limit usage with reset time, and lines added/removed. - Safe settings merge: Merges the statusLine configuration into ~/.claude/settings.json while preserving all existing settings and asking before overwriting a prior statusLine entry. - Use Case: After starting a new project session, ask to install the statusline so every subsequent response shows your current branch, remaining context, and rate limit status at the bottom of the terminal. ## Quick Start Install the Claude Code statusline so I can see my git branch, context usage, and rate limits in the terminal.

Frequently Asked Questions about 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?▼

Copy the statusline-command.sh script to ~/.claude/statusline-command.sh, make it executable with chmod +x, then add a statusLine entry of type command pointing to that script in ~/.claude/settings.json. The statusline appears from the next response onward.

What information does the Claude Code statusline display?▼

Line 1 shows the current directory name, git branch with detached HEAD fallback, worktree name, and model display name. Line 2 shows context window usage percentage, five-hour rate limit usage with reset time, and lines added or removed.

Does the statusline script require jq to be installed?▼

Yes, the script parses the JSON session input with a single jq call to extract directory, context, rate limit, cost, worktree, and model fields. If jq is missing, the installation instructions direct the user to install it first.

Will installing the statusline overwrite my existing settings.json?▼

No, the installation merges only the statusLine key into ~/.claude/settings.json and leaves all other settings untouched. If a statusLine entry already exists, the user is asked for confirmation before it is overwritten.

Why does the statusline not show a git branch in some directories?▼

The branch segment only appears when the current directory is inside a git repository, detected via git rev-parse. Outside a repository, or if git fails, the branch portion is silently omitted while the rest of the statusline still renders.

Related Skills

Explore More Software Engineering Skills→
Sampi314Sampi314
1

cs-customize-statusline

Guide PowerShell statusline customization with live terminal previews and automatic settings patching.

Community
Advanced
butterflyskiesbutterflyskies
1

token-audit

Monitor Claude Code session token usage and calculate API costs.

Official
Intermediate
Marcus-Mok-GHMarcus-Mok-GH

create-hooks

Create and configure Claude Code hooks for automated workflows and command validation.

Community
Advanced
daymadedaymade
1.3k

statusline-generator

Generate Claude Code statuslines with model, costs, path, and Git status.

Community
Intermediate