writing-statuslines

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

225|62|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/lexler/skill-factory --skill writing-statuslines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-statuslines
Source: https://github.com/lexler/skill-factory/tree/main/output_skills/ai/claude-code/writing-statuslines
Command: npx skills add https://github.com/lexler/skill-factory --skill writing-statuslines

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests>=2.31.0, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables developers to tailor Claude Code by providing custom status line scripts that surface live session data as a concise one-line status at the bottom of the interface.

Core Features & Use Cases

  • Status line scripting: Create scripts that read JSON input from Claude Code and emit a single line for display in the UI.
  • Configurable UX: Wire the script into your Claude settings (global or project level) to show model name, project directory, and session context.
  • Use Case: A developer can monitor the current model and project directory during long coding sessions without leaving the editor.

Quick Start

Review the references/anthropic-statusline.md for examples and guidance. Copy a sample shell, Python, or Node script that reads JSON from stdin and prints a single line. Save it as statusline.sh (or statusline.py) and make it executable with chmod +x. Point your settings.json to the script under the statusLine config and test by piping a JSON payload into the script to verify a one-line output.

Frequently Asked Questions about writing-statuslines

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

FAQPage Schema
How do I create a custom status line in Claude Code?

To create a custom Claude Code status line, write a script that reads JSON session data from stdin and outputs a single line to stdout, then enable it by adding the script path to your settings.json under the statusLine configuration.

What information can I display in a Claude Code status line?

A Claude Code status line can display at-a-glance session context such as the current model name, project directory, and session cost by parsing the JSON input provided to your custom script.

Does Claude Code status line scripting work with Python or Node?

Yes, Claude Code status line scripting works with Python, Node, or shell scripts. The script simply needs to read JSON from stdin and print a single line to stdout to function correctly.

How do I configure settings.json to show a status line in Claude Code?

You configure the status line in Claude Code by pointing your global or project settings.json to your executable script path under the statusLine config key, which enables the UI to render the script's output.

Why limit a status line script to a single stdout line?

Limiting the status line script to a single stdout line prevents cluttering the Claude Code UI prompts. The interface expects a concise one-line output at the bottom to display session context without disrupting your workflow.