← ClaudeAtlas

statuslinelisted

Configure a custom status line in the CLI. Use when the user mentions status line, statusline, statusLine, CLI status bar, prompt footer customization, or wants to add session context above the prompt.
kensaurus/cursor-kenji · ★ 4 · AI & Automation · score 77
Install: claude install-skill kensaurus/cursor-kenji
# CLI Status Line The CLI supports a user-configurable status line rendered above the prompt. A command is spawned on each conversation update, receives a JSON payload on stdin describing the session, and its stdout is displayed as the status line. The spec is aligned with [Claude Code's status line](https://code.claude.com/docs/en/statusline). ## Configuration Add a `statusLine` entry to `~/.cursor/cli-config.json`: ```json { "statusLine": { "type": "command", "command": "~/.cursor/statusline.sh", "padding": 2 } } ``` The `command` field supports full paths, `~` expansion, and shell-style argument splitting. You can point it at a script file or use an inline command like `jq -r '...'`. | Field | Required | Default | Description | |-------|----------|---------|-------------| | `type` | yes | — | Must be `"command"` | | `command` | yes | — | Path to an executable or inline command. `~` is expanded. | | `padding` | no | `0` | Horizontal inset (in characters) for the status line container. | | `updateIntervalMs` | no | `300` | Minimum interval between invocations. Clamped to >= 300ms. | | `timeoutMs` | no | `2000` | Maximum time the command may run before it is killed. | ## Stdin payload The command receives a JSON object on stdin. The TypeScript interface is `StatusLinePayload` in `packages/agent-cli/src/hooks/use-status-line.ts`. ### Full JSON schema ```json { "session_id": "abc123", "session_name": "my session", "transcript_path": "/path/to/tra