Skip to content
BENIBIX Learn

statusLine

AI⌨️ Claude CodeConfiguration

Also known as statusLine setting, "statusLine" key

The key that sets the command behind the status line.

Think of it like

It is like the dashboard in a car. You choose which gauges show under the wheel.

Example

Jack wants to see his git branch and the model at all times. He writes a small script and points statusLine at it.

Why it matters

The key is the only place the status line is turned on and told what to run.

Definition

statusLine is a settings key that sets up the status line. That is a line under the input box that shows what your own command prints. The key holds an object with type set to command and the command to run. padding adds space. refreshInterval runs it again every few seconds, and hideVimModeIndicator hides the vim label. Left unset, there is no status line.

Example code

json
{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh",
    "padding": 2
  }
}
Show your own script's output under the prompt.
Your command prints, and the line shows under the prompt.

Common mistake

Setting refreshInterval to 0. The smallest value is 1 second.

Key takeaways

  1. 1
    Runs your command. Under the prompt.
  2. 2
    Optional fields. padding, refresh.
  3. 3
    Off by default. Unset.