ACP status display: A dedicated space for ACP clients to report extended information

[kayakyakr]

Body

What are you proposing?

As an ACP-user, I would like to be able to report current client state so I can have context around things like context, usage limits, and other acp-specific information.

Why does this matter?

Specifically in the case of claude-agent-acp, we have a few different values that we would want to see displayed: context usage, 5h reset usage, and weekly usage. I propose a dedicated section of Zed for displaying this status with an interface from ACP not disimilar to the config options interface. In fact, I have done some amount of missuse of the options to implement something close to a solution here, as a PoC: agentclientprotocol/claude-agent-acp#568.

The issue is that this is largely a missuse of config options as it's not actually setting a config, while the use of space is not ideal.

I did not find a similar request, but I would not be surprised if it exists.

Are there any examples or context?

I achieved this hacky implementation by overriding config options:

Context usage %

5h cooldown

Possible approach

Ideal solution:

• Dedicated space for status indicator: docked left beside add context and follow toggles
• Max length with tooltip support
• Unicode support
• Zed caches visible session state, restores preferred visibility
• Tooltip displays all descriptions, right click edits visible state
• Zed handles debounce (if necessary)
• Set from ACP by calling

await this.client.sessionUpdate({
  sessionId,
  update: {
    sessionUpdate: "session_info_update",
    _meta: {
      sessionState: [
        {id: 'ctx', value: 'Ctx: 42%', description: 'Context: 42% [420k/1M]'},
        {id: '5h', value: '5h: 89% 0:15', description: '5h window: 89%. Resets at 4:00 ET.'},
      ]
    }
  },
});