writing-statuslines

name	writing-statuslines
description	Writes Claude Code status line scripts. Use when creating, customizing, or debugging statusline configurations.

STARTER_CHARACTER = 📊

Setup

Update the reference docs to get the latest from Anthropic:

python ~/.claude/skills/writing-statuslines/scripts/update-docs.py

What Status Lines Are

Custom scripts that display contextual information at the bottom of Claude Code's interface. Updated when conversation messages change, at most every 300ms.

Configuration

Add to ~/.claude/settings.json (user-level) or .claude/settings.json (project-level):

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

padding is optional. Set to 0 to let the status line reach the terminal edge.

How It Works

• Claude Code passes session context as JSON via stdin to the script
• First line of stdout becomes the status line text
• ANSI color codes supported
• Script must be executable (chmod +x)