[FEATURE] Add real-time token usage display to status line

Resolved 💬 3 comments Opened Oct 10, 2025 by guyguy2 Closed Oct 14, 2025

Preflight Checklist

  • [x] I have searched existing requests and this feature hasn't been requested yet
  • [x] This is a single feature request (not multiple features)

Problem Statement

Add an option to display token/context usage information in the Claude Code status line, similar to how
/config settings can be shown.

Motivation:

Currently, users must run /context to see token usage, which:

  • Interrupts workflow
  • Requires an extra command
  • Doesn't provide real-time visibility during conversations
  • Makes it harder to proactively manage context limits

Proposed Solution

Add a new status line configuration option (similar to existing git_status, directory, etc.):

token_usage: true # Shows current/max tokens and percentage

Example Status Line Display:

~/dev/project main 72k/200k (36%)

or with more detail:

~/dev/project main msgs:8 sys:26k free:128k

Alternative Solutions

_No response_

Priority

Medium - Would be very helpful

Feature Category

Interactive mode (TUI)

Use Case Example

_No response_

Additional Context

_No response_

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗