docs: clarify subscription usage surfaces (#2122)

This commit is contained in:
Carlos Florêncio
2026-08-01 12:04:15 +01:00
committed by GitHub
parent bb525f1894
commit 65b0e249ec
2 changed files with 40 additions and 2 deletions
+27 -1
View File
@@ -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