# statusLine

> The key that sets the command behind the status line.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** statusLine setting, "statusLine" key

## Think of it like

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

## 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

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

## Example code

```json
{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh",
    "padding": 2
  }
}
```

Show your own script's output under the prompt.

## Why it matters

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

## Common mistake

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

## Three principles

- **Runs your command.** Under the prompt.
- **Optional fields.** padding, refresh.
- **Off by default.** Unset.

## Related terms

- [Status Line](https://learn.benibix.com/term/ai/status-line)
- [fileSuggestion](https://learn.benibix.com/term/ai/file-suggestion-setting)
- [spinnerVerbs](https://learn.benibix.com/term/ai/spinner-verbs-setting)

![How the statusLine key works: Claude Code runs your command, and whatever it prints shows below the prompt.](https://learn.benibix.com/diagrams/status-line-setting-flow.svg)

---

Source: https://learn.benibix.com/term/ai/status-line-setting
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
