statusline-config

Configure the Claude statusline with a schema-driven UI and seeded config.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The statusline-config skill enables users to tailor the Claude Code statusline rendered by the statusline-plugin, facilitating a consistent, informative prompt experience across sessions.

Core Features & Use Cases

  • Defines how Claude reads and wires the runtime wrapper at ~/.claude/statusline-plugin/run and how it seeds and updates ~/.claude/statusline-plugin/config.json for the user's session.
  • Guides the user through configuring the statusline via the config file and the one-time settings integration in ~/.claude/settings.json, ensuring the statusline reflects model, cwd, time, and cost.
  • Supports easy adjustments to separators, segment colors, and layout to align with their workflow and preferences.

Quick Start

Ask Claude to configure the statusline to show model name, cwd, and time, and then write the wrapper path to your Claude settings.

Frequently Asked Questions about statusline-config

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

FAQPage Schema
How do I configure the Claude Code statusline to show model name and current working directory?

To configure the Claude Code statusline, you ask Claude to set up the runtime wrapper and seed the config.json file with your desired segments like model, cwd, time, and cost. This establishes a customizable, schema-driven UI inside your Claude Code prompt.

How does the statusline runtime wrapper integrate with my Claude settings?

The statusline runtime wrapper integrates by writing its path into your ~/.claude/settings.json file during a one-time setup. This linkage ensures the statusline plugin renders your customized segments consistently across all Claude Code sessions.

What's the best way to customize statusline segment colors and separators in Claude Code?

The best way to customize statusline segment colors and separators is by updating the ~/.claude/statusline-plugin/config.json file. This schema-driven configuration allows easy adjustments to layout, colors, and separators to match your workflow preferences.

Do I need to manually edit config.json to update my Claude Code statusline layout?

You do not need to manually edit config.json to update your Claude Code statusline layout. You can ask Claude to configure the statusline during a session, which guides the wrapper setup and automatically seeds or updates the configuration file for you.

Can I adjust the statusline configuration to display session cost and time in Claude Code?

Yes, you can adjust the statusline configuration to display session cost and time. By guiding the per-segment configuration in config.json, the setup ensures the statusline reflects model, cwd, time, and cost information during your Claude Code sessions.