skills.rest
assertchris
assertchrisCOMMUNITY
Explore all skills by this author →
𝕏@assertchrisGitHub

custom-usage-statusline

Configure a Claude Code statusline to display session and weekly usage percentages.

2|1|Updated Feb 19, 2026
Search Tags:#developer tools#monitoring#claude#configuration#statusline#usage
One-click install
npx skills add https://github.com/assertchris/claude-skills --skill custom-usage-statusline
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: custom-usage-statusline
Source: https://github.com/assertchris/claude-skills/tree/main/custom-usage-statusline
Command: npx skills add https://github.com/assertchris/claude-skills --skill custom-usage-statusline

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps users monitor their Claude AI usage directly within their coding environment by displaying session and weekly usage percentages in the statusline.

Core Features & Use Cases

  • Real-time Usage Monitoring: Provides immediate visual feedback on session (5h) and weekly (7d) usage limits.
  • Automated Setup: Guides the user through copying a script and configuring their settings.
  • Graceful Failure: Omits usage information if authentication or API calls fail, ensuring the statusline remains functional.
  • Use Case: A developer working on multiple projects can quickly glance at their statusline to see how close they are to their usage limits without interrupting their workflow.

Quick Start

Follow the instructions in the skill to set up the usage statusline.

Frequently Asked Questions about custom-usage-statusline

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

FAQPage Schema
How do I display Claude usage limits in my statusline?▼

You can display Claude usage limits in your statusline by configuring a custom statusline script that fetches your OAuth token, calls the usage API, and shows session and weekly limit percentages directly in your coding environment.

Does the Claude usage statusline work on Linux and macOS?▼

Yes, the Claude usage statusline supports both Linux and macOS environments, utilizing platform-specific credential retrieval methods to automatically extract the necessary OAuth tokens for the usage API.

What dependencies do I need to configure a Claude usage statusline?▼

You need jq and curl installed to configure the Claude usage statusline, as the script relies on these command-line tools to fetch OAuth tokens, call the usage API, and parse the returned JSON data for display.

What happens to the statusline if the Claude usage API call fails?▼

If the Claude usage API call or authentication fails, the statusline script handles the error gracefully by omitting the usage information, ensuring your statusline remains functional without breaking your workflow.

How does the statusline script track weekly and session usage limits?▼

The statusline script tracks weekly and session usage limits by calling the Claude usage API to fetch real-time data, caching the results to minimize API requests, and displaying the 5-hour session and 7-day weekly percentages.

Related Skills

Explore More Software Engineering Skills→
t-miura-024t-miura-024

mt-search-web

Search the web via SearXNG and convert retrieved pages to Markdown.

Community
Intermediate
dburkartdburkart
5

usage

Probe Anthropic rate-limit headers and output remaining quota percentages.

Community
Basic
jey3dayojey3dayo

herdr

Manages and optimizes herdr terminal multiplexer configuration settings and preferences.

Community
Advanced
shenxingyshenxingy
8

slt

Toggle Claude Code statusline quota pace indicator display modes and themes.

Community
Basic