skills.rest
nthpaul
nthpaulCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

statusline

Configure a command-driven status line rendering session context above the CLI prompt.

Updated May 18, 2025
Search Tags:#cli#token usage#cursor#status line#session context#json stdin#ansi styling
One-click install
npx skills add https://github.com/nthpaul/dotfiles --skill statusline-nthpaul
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: statusline
Source: https://github.com/nthpaul/dotfiles/tree/main/cursor/.cursor/skills-cursor/statusline
Command: npx skills add https://github.com/nthpaul/dotfiles --skill statusline-nthpaul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of not having enough at-a-glance information about your active CLI/AI session right above where you type.

Core Features & Use Cases

  • Custom status line rendering: Adds a user-defined status area that updates as the conversation changes, aligned to Claude Code’s status line behavior.
  • Dynamic, local command output: Runs a configurable executable (or inline command) on each update, then renders its stdout (including ANSI colors) above the prompt.
  • Context-aware payloads: Uses a structured JSON payload describing session, model, workspace, and context-window usage so you can display model name, token/progress, CWD/worktree info, and more.

Quick Start

Add a statusLine command entry to your ~/.cursor/cli-config.json to render your session context above the prompt by executing your statusline command.

Frequently Asked Questions about statusline

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I show real-time session context and context-window usage in the Cursor CLI prompt?▼

To display real-time session context in the Cursor CLI, configure a custom status line in your ~/.cursor/cli-config.json file. This renders model identity, token usage, and workspace details directly above the prompt.

How does a custom status line command receive session data like model name and token usage?▼

The custom status line command receives session data by reading a structured JSON payload on stdin. This payload includes session details, model identity, workspace info, and context-window usage for rendering.

Can I use ANSI colors and multi-line indicators in my CLI status line output?▼

Yes, the status line command supports ANSI-colored stdout output and optional multi-line indicators. The command executes your script and renders its stdout directly above the prompt during active sessions.

How do I configure the Cursor CLI status line to run a local command?▼

Add a statusLine entry with type set to "command" in your ~/.cursor/cli-config.json file. This setup executes your specified local command on each update to render dynamic session context.

Does the status line command require any specific dependencies or external libraries?▼

No external dependencies are required to use the status line command. It relies on a local executable or inline command that reads JSON from stdin and outputs ANSI-colored text to stdout.

What information is available in the JSON stdin payload for status line rendering?▼

The JSON stdin payload provides session context including model name, context-window usage, current working directory, workspace info, and token progress to display in your custom status line.

Related Skills

Explore More Software Engineering Skills→
fredericpoitevinfredericpoitevin

statusline

Configure a CLI status line in ~/.cursor/cli-config.json to render session metadata above the prompt.

Community
Intermediate
lexlerlexler
225

writing-statuslines

Configure Claude Code to display live session data via custom status line scripts.

Community
Intermediate
erbsland-deverbsland-dev

erbsland-ansi-for-sphinx

Embed static ANSI blocks in Sphinx docs using the erbsland-ansi directive.

Community
Intermediate
lewinglewing
4

maestro-cli

Fetch Maestro/BAR dependency flow data via the mstro CLI with JSON output.

Community
Intermediate