Feature Request: Include /usage percentages (Session %, Week %) in statusline JSON payload

Resolved 💬 1 comment Opened Dec 19, 2025 by ccn-noh-siyoung Closed Dec 19, 2025

Feature Request

Summary

Please include the usage percentages displayed by the /usage command in the statusline JSON payload.

Current Behavior

The statusline JSON payload currently includes:

  • cost.total_cost_usd - Session cost in USD
  • context_window.current_usage.* - Token counts for context window

However, it does not include:

  • Current session usage percentage
  • Current week usage percentage

These percentages are only visible via the /usage command.

Requested Behavior

Add the following fields to the statusline JSON payload:

{
  "usage": {
    "session_percent": 25,
    "week_percent": 63
  }
}

Or alternatively:

{
  "usage": {
    "session": {
      "used": 12500000,
      "limit": 50000000,
      "percent": 25
    },
    "week": {
      "used": 315000000,
      "limit": 500000000,
      "percent": 63
    }
  }
}

Use Case

Many users create custom statusline scripts to monitor their Claude Code usage in real-time. Having access to the session and weekly usage percentages would allow users to:

  1. Monitor usage limits - Avoid hitting rate limits unexpectedly
  2. Budget awareness - Track usage against daily/weekly quotas
  3. Better planning - Make informed decisions about when to use different models

Example Statusline Output

With this feature, users could display:

🤖 Opus 4.5  ⎇ main  🧠 72%  ⚡ Session 25%  📅 Week 63%

Environment

  • Claude Code CLI
  • Statusline feature with custom bash scripts

Thank you for considering this feature request!

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗