Skip to content

Control UI: add visible context/token usage indicator #2031

@zepgram

Description

@zepgram

Feature request

Add a visible context/token usage indicator in the Control UI webchat interface.

Problem

Currently, the only way to check context usage is:

  • Ask the agent to run session_status (consumes tokens)
  • Run clawdbot status from CLI
  • Check the Sessions tab (requires switching views)

There's no at-a-glance indicator while chatting.

Proposed solution

A persistent UI element (progress bar, badge, or status line) showing:

  • Tokens used / max (e.g. 44k/200k)
  • Percentage (e.g. 22%)
  • Visual alert when approaching limits (color change at >80%, >90%)

Mockup ideas

  • Small progress bar under the chat input
  • Badge in the header: 📊 44k/200k (22%)
  • Status line that turns orange/red when context is running low

Why it matters

Users need to know when to /clear or start a new session before hitting context limits and losing conversation history to compaction.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions