Custom Status Line Setup

Custom Status Line Setup

Sets up a comprehensive Claude Code status line with Nerd Font icons only (no emojis), ANSI colors, real-time usage tracking, git integration, and system monitoring.

Quick Start: Interactive Configuration

Run the /​custom-statusline command to interactively configure your status line. It will ask which elements you want:

• Current directory - Working directory path
• Nerd Font icons - All icons (os, git, clock, usage) - all or nothing
• Git branch & status - Branch, dirty/​clean, ahead/​behind, stash
• Model name - Current Claude model
• Session duration - Time elapsed in session
• API usage (5h/​7d) - Claude API usage percentages
• Context % till compact - Context window usage

The command will save your preferences to ~/​.claude/​statusline-config.json and configure settings to use the plugin's script.

Features

Git Integration

• Clean/​dirty status indicator
• Modified file count
• Ahead/​behind tracking
• Stash count display
• Branch name with color coding

Usage Tracking

• 5-hour and 7-day usage percentages from Anthropic API
• Color-coded thresholds (green <50%, yellow 50-80%, red >80%)
• Cached for 60 seconds to avoid API spam

Context Display

• Session context window percentage
• Color-coded by usage level

Cost & Duration

• Total duration in minutes

How It Works

• Script: Stays in the plugin folder at ${CLAUDE_PLUGIN_ROOT}/​scripts/​statusline.sh
• Config: Saved to ~/​.claude/​statusline-config.json (persists across plugin updates)
• Settings: Points to the plugin's script via dynamic lookup

Manual Setup

If you prefer manual setup instead of the command:

Step 1: Create Config File

Create ~/​.claude/​statusline-config.json:

{
  "show_cwd": true,
  "show_icons": true,
  "show_git": true,
  "show_model": true,
  "show_duration": true,
  "show_usage": true,
  "show_context": true
}

Step 2: Update Claude Settings

Update ~/​.claude/​settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "bash -c \"$(find ~/​.claude/​plugins/​cache/​zeul-claude-plugins/​custom-statusline -name statusline.sh 2>/​dev/​null | head -1)\""
  }
}

Step 3: Test Status Line

echo '{}' | bash -c "$(find ~/​.claude/​plugins/​cache/​zeul-claude-plugins/​custom-statusline -name statusline.sh | head -1)"

Requirements

Essential

• Nerd Font installed - For icons (JetBrains Mono, Hack, FiraCode, etc.)
• jq installed - For JSON parsing (brew install jq)
• Git installed - For git features
• curl - For API usage fetching

Platform-Specific (macOS)

• security - Keychain access for API token

Troubleshooting

Icons not showing: Install a Nerd Font and configure your terminal to use it

No git branch: Script shows nothing when not in a git repository

Usage shows 0%: API call failed. Check:

• Keychain has "Claude Code-credentials"
• Internet connection active
• API endpoint accessible

Slow status line: Increase cache_max_age in the script to reduce API calls

Reconfigure: Run /​custom-statusline again to change your preferences