# Status Line

> A bar under the prompt, filled by a script you choose.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** Claude Code status line, /statusline, statusLine

## Think of it like

It is like the dash in a car. It shows your speed and fuel as you drive.

## Definition

The status line is a bar at the bottom of Claude Code that you can set up to show anything. It runs a shell script you choose. Claude Code sends the script details about the session as JSON, such as the model, the folder and how full the context is. Whatever the script prints is shown in the bar. Run /statusline and describe what you want, and Claude Code writes the script for you.

## Example

Jack keeps losing track of how full the context is. He adds a status line with a small bar that fills up as the session grows.

## Example code

```console
/statusline show the model and the git branch
```

Ask Claude Code to build a status line for you.

## Why it matters

Key facts stay in view, so you do not have to ask for them.

## Common mistake

Writing a slow script. It runs often, so a slow one makes the whole screen feel slow.

## Three principles

- **A bar at the bottom.** Always in view.
- **Your script.** Prints what shows.
- **Gets session data.** As JSON.

## Related terms

- [JavaScript Object Notation (JSON)](https://learn.benibix.com/term/development/json)
- [Shell](https://learn.benibix.com/term/infrastructure/shell)
- [Context Window](https://learn.benibix.com/term/ai/context-window)

## Taught in

- [Skills, Plugins and Styles](https://learn.benibix.com/learn/ai-claude-code/skills-plugins-and-styles): Claude Code, 14/16

![A bar under the prompt showing the model, the folder, the git branch and how full the context is.](https://learn.benibix.com/diagrams/cc-status-line.svg)

---

Source: https://learn.benibix.com/term/ai/status-line
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-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
