Statusline Setup

What it does

This skill allows you to configure a dynamic status line within your Claude Code environment, displaying contextual information at the bottom of the interface. The status line updates automatically as conversation messages change (up to every 300ms). You can customize what's displayed, including model name, Git branch, token usage, project colors, and session cost, using either a custom script or a widget-based approach.

When to use it

• You want to quickly see the Claude Code model you are using directly in your terminal.
• You need to monitor token usage for cost tracking purposes.
• You'd like to display Git branch information within your coding environment.
• You prefer a visual indicator of project colors or session costs.

Key capabilities

• Customizable Status Line: Displays dynamic information in the Claude Code interface.
• Multiple Approaches: Supports both manual script creation (for full control) and integration with the ccstatusline widget.
• Information Display: Shows model name, Git branch, project colors, token usage, session cost, current directory, and more.
• JSON Input: Receives structured JSON data containing information about the Claude Code environment.

Example prompts

While this skill is configured through settings rather than direct prompting, here are examples of what an agent might do after it has been installed:

• "Configure my status line to show the model name and Git branch."
• "Set up a status line using the ccstatusline widget."
• "Create a custom script for my status line that displays token usage."

Tips & gotchas

• Existing Configuration: The skill checks for existing status line configurations. Back up your current settings before proceeding.
• Manual Scripting: If using the manual scripting approach, you'll need to create and maintain a shell script (~/.claude/statusline.sh) that processes JSON input.
• ccstatusline Dependency: Using the ccstatusline method requires installing this third-party tool separately.