statusline

Render a custom CLI status line from JSON session context.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/min-zou/obsidian-doc --skill statusline-min-zou
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: statusline
Source: https://github.com/min-zou/obsidian-doc/tree/main/format/areas/system/agent-skills/cursor-builtin/statusline
Command: npx skills add https://github.com/min-zou/obsidian-doc --skill statusline-min-zou

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, displaying session context above the prompt.

Core Features & Use Cases

  • Customizable Status Line: Render a status line above the prompt with user-defined content.
  • Session Context: Display information like model name, context usage, and more.
  • Use Case: For users who want to see the current session context at a glance, such as the model in use, the amount of context used, and the current working directory.

Quick Start

Set up your custom status line by editing the statusLine entry in ~/.cursor/cli-config.json.

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 prompt to show session context?

You can customize your CLI prompt by editing the `statusLine` entry in `~/.cursor/cli-config.json`. This renders a custom status line above the prompt, displaying session details like model name and context usage.

What is a custom status line in the CLI and how does it work?

A custom CLI status line is a user-defined display rendered above the prompt. It works by executing a command that receives a JSON payload on stdin with session details and outputs the formatted status line as stdout.

Can I display model name and context usage in my CLI prompt footer?

Yes, the status line displays session context at a glance. The JSON payload includes session details like the model name in use, the amount of context used, and the current working directory.

Does customizing the prompt footer require any additional dependencies?

No additional dependencies are required. You only need to configure the `statusLine` entry in `~/.cursor/cli-config.json` to start rendering session context in your CLI.

What is the best way to monitor context usage during a CLI session?

Setting up a custom status line is an effective way to monitor context usage. It renders session context above the prompt, allowing you to see the amount of context used at a glance without running separate commands.