statusline

Render a live CLI status line from JSON session payloads.

1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/PandelisZ/skills --skill statusline-pandelisz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: statusline
Source: https://github.com/PandelisZ/skills/tree/main/skills/statusline
Command: npx skills add https://github.com/PandelisZ/skills --skill statusline-pandelisz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The CLI supports a configurable status line rendered above the prompt. A spawned command receives a JSON payload on stdin describing the session and its stdout is displayed as the status line, providing immediate context without interrupting the conversation flow.

Core Features & Use Cases

  • Live, per-update status line generated from a JSON payload that includes session, model, and workspace details.
  • Configurable via ~/.cursor/cli-config.json by adding a statusLine entry to point to a script or executable.
  • Use cases include long-running sessions, multi-task prompts, and debugging workflows where context visibility is critical.

Quick Start

Add a statusLine entry to your ~/.cursor/cli-config.json and point the command to a script that outputs 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 display a live CLI status line with session context?

To display a live CLI status line, add a statusLine entry to your ~/.cursor/cli-config.json pointing to a script that reads a JSON payload on stdin and renders session details to stdout.

What information can I show in a CLI status line prompt?

A CLI status line prompt can display session information from a JSON payload, including active model, workspace, and transcript details, providing immediate context for long-running tasks and debugging.

How do I configure the status line update interval and padding?

You configure the status line update interval and optional padding by modifying the statusLine entry within your ~/.cursor/cli-config.json file to control how the rendered output behaves.

Does the CLI status line work for long-running tasks and multi-task prompts?

Yes, the CLI status line supports long-running tasks and multi-task prompts by rendering per-update payloads that keep session context visible without interrupting the conversation flow.

Can I use a custom script to generate my CLI status line?

Yes, you can use a custom executable script to generate your CLI status line by specifying its path in the statusLine configuration entry inside ~/.cursor/cli-config.json.

Why do I need a status line for my CLI debugging workflow?

You need a status line for CLI debugging workflows because it provides immediate visibility into session, model, and workspace context, preventing context loss during long-running or multi-task prompts.