statusline

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

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/fredericpoitevin/.cursor --skill statusline-fredericpoitevin
Or copy as Structured Prompt for Agent
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.