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