Claude Code Statusline Configuration Skill

MANDATORY: This skill MUST be used when the user requests Claude Code statusline configuration.

Trigger Conditions

Automatically use this skill when any of the following instructions are given:

"Set up the statusline"
"Setup statusline"
"Configure statusline"
"Statusline setup"
"Set up the status bar"
"Initialize status line"
"Claude Code statusline"

Purpose

Automatically configure Claude Code statusline display
Add statusline configuration to global settings (~/.claude/settings.json)
Create a custom script (~/.claude/statusline.sh)
Safely merge while preserving existing settings

Skill Invocation Method

This skill is invoked using the Skill tool:

Skill(skill="setup-statusline")

No arguments are required.

Execution Steps

1. Running Setup

.claude/skills/setup-statusline/setup.sh

This script automatically executes the following:

Prerequisites Check: Verify jq command installation
Directory Creation: Check/create ~/.claude/ directory
Settings File Merge: Add statusLine section to ~/.claude/settings.json (preserving existing settings)
Script Creation: Create ~/.claude/statusline.sh and grant execute permission

2. Configuration Details

Configuration to be added (~/.claude/settings.json):

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh",
    "padding": 0
  }
}

Script to be created (~/.claude/statusline.sh):

Directory name
Git branch name (in parentheses)
Model name (in square brackets)
Token information (total, input, output, cache)

3. Display Example

gendosu-claude-plugins (main) [Sonnet] | 📊 38.8K (In:37442 Out:0 Cache:0)

4. Execution Result Determination

✅ Success: Script exits with code 0 and displays success message
❌ Failure: Script exits with non-zero code and displays error message

Important Rules

Existing Settings Protection: Existing settings.json settings are preserved
Automatic Backup Creation: Automatically creates .backup files when updating configuration
Idempotence: Safe to run multiple times
jq Required: jq command is necessary for JSON operations

Security

Script permissions: 755 (rwxr-xr-x)
Configuration file permissions: 644 (rw-r--r--)
Operates only within home directory
No sudo privileges required

Troubleshooting

When jq is not found

macOS:

brew install jq

Ubuntu/Debian:

sudo apt-get install jq

Fedora/RHEL:

sudo dnf install jq

When permission errors occur

Check permissions for ~/.claude/ directory:

ls -ld ~/.claude/
chmod 755 ~/.claude/

References

README.md - Detailed usage instructions and troubleshooting

setup-statusline