statusline

Configure a custom CLI status line by executing a script on each conversation update.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/shankur/dots --skill statusline-shankur
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: statusline
Source: https://github.com/shankur/dots/tree/main/dot_cursor/skills-cursor/statusline
Command: npx skills add https://github.com/shankur/dots --skill statusline-shankur

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) components.

What problem does it solve?

This Skill allows users to configure a custom status line in their CLI, providing a personalized and informative experience above the prompt.

Core Features & Use Cases

  • Customizable Status Line: Create a status line that shows the current session, model, context usage, and more.
  • Dynamic Content: Status line updates dynamically based on session data, such as the current working directory, model, and context usage.
  • Scriptable Configuration: Use a script or inline command to generate the status line, with options for padding and update intervals.

Quick Start

Add the statusLine configuration to your .cursor/cli-config.json file with the command path to your statusline.sh script.

Frequently Asked Questions about statusline

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

FAQPage Schema
How do I customize the CLI status line in Claude Code?

You can customize the CLI status line by configuring a script in your .cursor/cli-config.json file that receives session JSON via stdin and outputs the status line text. The script executes on each conversation update to display dynamic session details.

What information can I display in a custom CLI status bar?

A custom CLI status bar can display the current working directory, active model, session context, and context usage. It updates dynamically by processing the JSON payload containing session details passed to your script.

Do I need jq to configure a CLI status line?

Yes, you need jq installed to process the JSON payload. The status line script receives session details as JSON on stdin, and jq is required to parse this data and extract the values for your prompt customization.

How does a scriptable status line update during a CLI session?

The scriptable status line updates dynamically on each conversation update. Your script receives a JSON payload with session data on stdin, processes it, and outputs the formatted status line text above the prompt.

Can I use inline commands instead of a script for prompt customization?

Yes, you can use either a script file or an inline command to generate the status line. Both approaches process the session JSON payload to output text, with options available for padding and update intervals.