statusline-setup

Configure Claude Code statusline to display model, context, cache, and session cost metrics.

1.0k|91|Updated Jul 9, 2025

Search Tags:#metrics #statusline #jq #display # Claude Code

Ready to run

npx skills add https://github.com/fcakyon/claude-codex-settings --skill statusline-setup

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: statusline-setup
Source: https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/claude-tools/skills/statusline-setup
Command: npx skills add https://github.com/fcakyon/claude-codex-settings --skill statusline-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq.

What problem does it solve?

This Skill configures the Claude Code statusline to display model, context usage, cache hit rate, and session costs, with color-coded guidance.

Core Features & Use Cases

Display options: Native statusline with color-coded context usage.
Cache & cost: Show cache hit rate and per-session cost.
Requirements: Ensure jq is available for statusline rendering.

Quick Start

Install jq if needed, then configure /claude-tools:statusline-setup to tailor the display.

Frequently Asked Questions about statusline-setup

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

FAQPage Schema

How do I display real-time context usage metrics in Claude Code?▼

Configure the statusline to display real-time context usage metrics by running the statusline-setup Skill, which adds color-coded percentage displays, cache hit rates, and session costs to your Claude Code interface during interactive sessions.

What do I need to set up a Claude Code statusline with usage metrics?▼

You need jq installed on macOS or Ubuntu/Debian, plus standard Claude Code setup. The statusline-setup Skill handles configuration to render model name, context percentage, cache percentage, and session cost with color coding.

Can I customize what metrics appear in my Claude Code statusline?▼

Yes, the statusline-setup Skill lets you choose between Native (color-coded), ccusage, or Disable display options to tailor which metrics—model name, context percentage, cache hit rate, and session cost—appear in your statusline.

Why should I monitor cache hit rate and session cost in my Claude Code statusline?▼

Displaying cache hit rate and session cost in your statusline provides real-time visibility into API efficiency and spending across interactive sessions, helping you optimize usage patterns and track cumulative costs.

Does statusline configuration work on both macOS and Linux?▼

Yes, statusline-setup supports macOS and Ubuntu/Debian systems. Both require jq and standard Claude Code setup; the Skill configures the statusline identically across these platforms.