Statusline
A rich statusline showing git, token usage, and session cost.
The custom statusline shows live session information at the bottom of Claude Code, so you always know your context and spend.
What it shows
- Current git branch and change count
- Context remaining
- Tokens used
- Session and rolling cost (via
ccusage) - Five-hour and weekly limits
- Task progress
How it is installed
During agents setup, the CLI:
- Copies the statusline scripts into
~/.claude/scripts. - Installs
bunandccusageif they are missing. - Runs
bun installinside the scripts directory. - Adds a
statusLineentry to~/.claude/settings.json:
{
"statusLine": {
"type": "command",
"command": "bun ~/.claude/scripts/statusline/src/index.ts"
}
}
Codex
For Codex, the same information is configured through the status_line
components in ~/.codex/config.toml:
[tui]
status_line = [
"model-with-reasoning",
"git-branch",
"branch-changes",
"context-remaining",
"used-tokens",
"five-hour-limit",
"weekly-limit",
"task-progress"
]