claude-code - 💡(How to fix) Fix Add context_breakdown to statusline hook JSON input [1 comments, 2 participants]

TL;DR

Exposing the per-category breakdown of context window usage in the statusline JSON would allow external monitoring tools to display actionable context health metrics.

Guidance

• Add a breakdown object to the context_window JSON object, containing the per-category token counts, as proposed in the issue.
• Update the statusline hook to include this new breakdown object in its output.
• Verify that the updated statusline JSON contains the expected breakdown data by checking the output of the statusline hook.
• Use the new breakdown data in external monitoring tools, such as the proposed macOS menu bar widget, to display stacked context bars per active session.

Example

{
  "session_id": "...",
  "context_window": {
    "used_percentage": 13,
    "total_input_tokens": 133200,
    "context_window_size": 1000000,
    "breakdown": {
      "system_prompt_tokens": 6000,
      "system_tools_tokens": 10500,
      "memory_files_tokens": 354,
      "skills_tokens": 761,
      "messages_tokens": 115600,
      "autocompact_buffer_tokens": 33000,
      "free_tokens": 833800
    }
  }
}

Notes

The proposed solution assumes that the /context endpoint already computes the per-category breakdown, and that the cost of emitting this data to the statusline is near-zero.

Recommendation

Apply the proposed workaround by adding the breakdown object to the statusline JSON, as it would provide valuable context health metrics to external monitoring tools without incurring significant additional costs.