statusline

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

Updated Apr 11, 2026

Search Tags:#cli #bash #configuration #terminal #statusline #prompt #session-context

Ready to run

npx skills add https://github.com/fredericpoitevin/.cursor --skill statusline-fredericpoitevin

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: statusline
Source: https://github.com/fredericpoitevin/.cursor/tree/main/skills-cursor/statusline
Command: npx skills add https://github.com/fredericpoitevin/.cursor --skill statusline-fredericpoitevin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Configure a custom status line in the CLI to surface session context above the prompt, reducing cognitive load and giving you immediate visibility into the current workspace during conversations.

Core Features & Use Cases

Render a status line above the prompt on every conversation update by spawning a command that consumes a JSON payload on stdin and outputs the status line to render.
Expose configuration options in ~/.cursor/cli-config.json for type, command, padding, updateIntervalMs, and timeoutMs, enabling flexible responsive behavior.
Use cases include keeping model, working directory, transcript path, and session metadata visible during long-running chats or developer sessions.

Quick Start

Add a statusLine entry in ~/.cursor/cli-config.json and point the command to a script or inline command that prints the status line.

Frequently Asked Questions about statusline

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

FAQPage Schema

How do I show session context in a CLI status line above the prompt?▼

To show session context in a CLI status line, configure a custom command in ~/.cursor/cli-config.json that reads a JSON payload from stdin and outputs the status line text to stdout for rendering above the interactive prompt.

What metadata can I display in a terminal status line during interactive sessions?▼

You can display real-time session metadata in a terminal status line including the current model, working directory, transcript path, and workspace details to maintain visibility during long-running chats.

How do I configure update intervals and timeout for a CLI status line?▼

Configure update intervals and timeout for a CLI status line by setting the updateIntervalMs and timeoutMs properties within the statusLine entry located in your ~/.cursor/cli-config.json file.

Can I use a bash script to render a live prompt status line?▼

Yes, you can use a bash script to render a live prompt status line by specifying the script as the command in your CLI configuration, which receives session context via stdin and prints the formatted output.

Why configure a custom status line for terminal sessions?▼

Configuring a custom status line for terminal sessions reduces cognitive load by surfacing immediate workspace context above the prompt, keeping essential session details visible without manual checks.