skills.rest
TheFVG
TheFVGOFFICIAL
Explore all skills by this author →
WebsiteGitHub

statusline

Execute a command per conversation update to display a custom CLI status line.

Updated Aug 27, 2026
Search Tags:#CLI#command execution#status line#session context#prompt customization
One-click install
npx skills add https://github.com/TheFVG/proof-deals --skill statusline-thefvg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: statusline
Source: https://github.com/TheFVG/proof-deals/tree/main/docs/agent-index/snapshots/skills-cursor/statusline
Command: npx skills add https://github.com/TheFVG/proof-deals --skill statusline-thefvg

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill allows users to configure a custom status line in the CLI, enhancing the user experience and providing additional context above the prompt.

Core Features & Use Cases

  • Customizable Status Line: Users can define the content and appearance of their CLI status line.
  • Command Execution: The Skill executes a specified command on each conversation update, displaying the output as the status line.
  • Use Case: A developer might use this Skill to display the current branch name and context usage percentage in their CLI status line.

Quick Start

Set up a custom status line by adding the following to your ~/.cursor/cli-config.json:

{
  "statusLine": {
    "type": "command",
    "command": "~/.cursor/statusline.sh",
    "padding": 2
  }
}

Frequently Asked Questions about statusline

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

FAQPage Schema
How do I customize my CLI status line with a custom command?▼

To customize your CLI status line, configure a JSON file to specify a command type and execution script. The system executes this command on each conversation update, displaying the output as your custom status line above the prompt.

Can I display multiple lines and ANSI colors in my command line status line?▼

Yes, the custom status line supports both multiple lines and ANSI color codes. You can define the content and appearance within your execution script to display rich, formatted context above your CLI prompt.

What session context information is available for prompt customization?▼

Prompt customization receives a JSON payload with session details on each conversation update. Your execution script can parse this JSON payload to display dynamic session context, such as current branch name or context usage percentage.

Does CLI status line configuration require any external dependencies?▼

No, CLI status line configuration requires no external dependencies. You only need to define a JSON configuration pointing to your execution script, and the system handles running it to display the output.

What is the best way to show context usage percentage in my terminal prompt?▼

The best way to show context usage is to configure a custom status line. Write a script that parses the session details JSON payload, extract the usage metric, and output it with ANSI color codes for display above your prompt.

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
nthpaulnthpaul

statusline

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

Community
Intermediate
assertchrisassertchris
2

custom-usage-statusline

Configure a Claude Code statusline to display session and weekly usage percentages.

Community
Intermediate
lexlerlexler
225

writing-statuslines

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

Community
Intermediate