context-window-statusline

Generate and install a customizable Claude Code status line from JSON session data.

2|1|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/sejas/ai-code-skills --skill context-window-statusline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: context-window-statusline
Source: https://github.com/sejas/ai-code-skills/tree/main/plugins/context-window-statusline
Command: npx skills add https://github.com/sejas/ai-code-skills --skill context-window-statusline

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the need to monitor and understand the current usage of the Claude context window, including token counts, session cost, and performance metrics, directly within the terminal.

Core Features & Use Cases

  • Real-time Status Line: Displays a customizable footer bar in the Claude Code terminal.
  • Visual Metrics: Shows context window usage percentage, token counts (input/output/cached), session cost, and duration.
  • Use Case: Developers can quickly gauge their token consumption and estimated cost during a session, helping them optimize prompts and manage API usage effectively.

Quick Start

Install the status line script and configure your settings.json to display context window usage in your terminal footer.

Frequently Asked Questions about context-window-statusline

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

FAQPage Schema
How do I visualize Claude Code context window usage in the terminal?

You can visualize Claude Code context window usage by installing a customizable status line script that parses JSON session data via stdin to display real-time metrics like token counts, cost, and duration directly in your terminal footer.

Can I monitor session token counts and cost during a Claude Code session?

Yes, you can monitor session token counts and cost by configuring a status line that reads JSON session data to display context window percentage, input/output/cached tokens, session cost, and duration in real-time.

Do I need jq to display a context window status line in Claude Code?

Yes, you need jq installed because the status line script uses it to extract data from JSON session inputs received via stdin before formatting the terminal display output.

What is the best way to track context window percentage in a terminal status line?

The best way to track context window percentage is using a bash status line script that parses session JSON to show the percentage, total window size, and token counts in your terminal footer.

How do I configure settings.json to show Claude Code metrics in the terminal footer?

You configure settings.json to show Claude Code metrics by installing the status line script and pointing the configuration to parse session data, enabling a visual footer bar with model, tokens, and cost information.