From 65b0e249ec6ebeff14b058e79584c31f9552ac0e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Carlos=20Flor=C3=AAncio?= Date: Sat, 1 Aug 2026 12:04:15 +0100 Subject: [PATCH] docs: clarify subscription usage surfaces (#2122) --- docs/public/agents-and-profiles.md | 28 +++++++++++++++++++++++++++- docs/public/sessions-and-review.md | 14 +++++++++++++- 2 files changed, 40 insertions(+), 2 deletions(-) diff --git a/docs/public/agents-and-profiles.md b/docs/public/agents-and-profiles.md index ac90942231..854c724f0b 100644 --- a/docs/public/agents-and-profiles.md +++ b/docs/public/agents-and-profiles.md @@ -92,7 +92,33 @@ Model, mode, command, and configuration choices are probed from the locally inst Use the profile refresh control after installing, authenticating, or upgrading an agent. A manual refresh updates both the advertised models, modes, and commands and the visible capability status, so an old failure banner does not remain authoritative after the local CLI recovers. -**Settings > Agents** shows **Subscription Usage** only when a supported host agent is signed in through a subscription plan. The current section covers Codex and Claude Code, reports the provider's plan and rate-limit windows, and can be refreshed on demand. It is an operational signal from the installed CLI, not a billing ledger or a guarantee that the next request will be accepted; provider availability, account policy, and concurrent usage still apply. +### Monitor Office agent quota + +> [!EXPERIMENTAL] +> Office mode is feature-flagged and disabled in the production profile by +> default. Enable **Office mode** under **Settings > System > Feature Toggles** +> and restart Kandev to try it; its routes and agent surfaces are still in +> progress. For stable host-CLI installation and profile configuration, use +> **Settings > Agents**. + +When [Office mode](feature-status.md) is enabled, open **Office > Agents** and +select an Office agent to see its **Subscription Quota** on the overview; the +Office dashboard also summarizes the highest utilization across subscription +agents. These cards appear only for supported subscription agents with provider +credentials. + +For account-wide provider usage across supported providers, install the +[Provider Usage plugin](https://github.com/kdlbs/kandev-plugin-provider-usage). +It adds a provider pill to the session top bar and can add a compact display to +the global status bar. The optional status-bar display requires **App status +bar** to be enabled under **Settings > System > Feature Toggles**; enable it +and restart Kandev for the change to take effect. If it remains disabled, the +session top-bar pill remains available; enabling it also adds the global +status-bar and phone Status drawer display. Configure the plugin under +**Settings > Plugins > Provider Usage**. These usage surfaces are operational +signals, not a billing ledger or a guarantee that the next request will be +accepted; provider availability, account policy, and concurrent usage still +apply. ### CLI flags diff --git a/docs/public/sessions-and-review.md b/docs/public/sessions-and-review.md index 426f32d33d..9262f7c051 100644 --- a/docs/public/sessions-and-review.md +++ b/docs/public/sessions-and-review.md @@ -108,7 +108,19 @@ All panels for a task point at the same task environment. In a multi-repository Structured shell-command activity keeps the command, working directory, status, and output size in the chat row. Expand **Output** to fetch the transcript; Kandev continues refreshing an open, running command and stops when it reaches a terminal state. The disclosure separates standard output and errors, reports truncation and the exit code when known, and offers **Retry** when the transcript request fails. Historical command transcripts are loaded only when opened, which keeps long conversations responsive without discarding the stored output. -The ring in the chat-input toolbar shows the active session's context-window use when the agent reports a trustworthy window size. Open it to see used and total tokens. For a supported Codex or Claude Code subscription session, the same popover also fetches the account plan and rate-limit windows; opening it again requests fresh provider data, subject to a short server-side refresh clamp. Kandev hides the ring instead of presenting impossible data when reported use exceeds the reported window, and agents without usage support show no subscription rows. +The ring in the chat-input toolbar shows the active session's context-window use +when the agent reports a trustworthy window size. Open it to see used and total +tokens; it focuses on the active session's context window. For account-wide +provider usage, install the [Provider Usage +plugin](https://github.com/kdlbs/kandev-plugin-provider-usage), which adds a +provider pill to the session top bar and can add a compact display to the global +status bar. The optional status-bar display requires **App status bar** to be +enabled under **Settings > System > Feature Toggles**; enable it and restart +Kandev for the change to take effect. The session top-bar pill remains available +on its own, while enabling App status bar also adds the global status-bar and +phone Status drawer display. Configure the plugin under **Settings > Plugins > +Provider Usage**. Kandev hides the context ring rather than presenting +impossible data when reported use exceeds the reported window. ## Inspect changes