@slkiser/opencode-quota 3.6.2 → 3.8.0

package/README.md

@@ -15,11 +15,11 @@
   <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square" /></a>
 </p>
 
-[![OpenCode Quota sidebar](https://shawnkiser.com/opencode-quota/sidebar.webp)](https://github.com/slkiser/opencode-quota)
+[![OpenCode Quota sidebar](https://shawnkiser.com/opencode-quota/opencode-quota-sidebar.webp)](https://github.com/slkiser/opencode-quota)
 
 ---
 
-### Quick start
+## Install
 
 ```bash
 npx @slkiser/opencode-quota init
@@ -28,32 +28,88 @@ npx @slkiser/opencode-quota init
 > [!IMPORTANT]
 > OpenCode `>= 1.4.3` and Node.js `>= 18` are required.
 
-The installer is append-only: it adds the plugin, asks a few display/provider questions, and leaves existing values alone.
+The installer adds missing plugin/config entries and keeps your unrelated settings. Re-running it updates only installer-owned Quota UI choices.
 
-After install:
+### What the installer asks
+
+| Question | Pick this when you want... |
+| --- | --- |
+| Install scope | This repo/worktree only, or your global OpenCode config. |
+| Quota UI | Sidebar panel, toasts, compact status line, terminal/slash-command only, or a mix. |
+| Provider mode | Auto-detect providers, or choose a provider list yourself. |
+| Quota reset periods | Show one reset period per provider, or all known reset periods. |
+| Quota percentage meaning | Show quota remaining, or quota already used. |
+| Session token details | Hide token counts for shorter output, or show them when available. |
+
+### After install
 
 1. Restart OpenCode.
 2. Run `/quota`.
 3. If something looks wrong, run `/quota_status`.
-4. If you enabled the sidebar, open the session sidebar and look for the `Quota` panel.
+4. If you enabled the Sidebar panel, open the session sidebar and look for `Quota`.
+5. If you enabled Compact status line, look for the home-bottom quota line and the chat/session prompt quota line.
 
-Terminal-only check:
+### Terminal-only check
 
-Use `npx` when you want to run the published package without installing the binary first:
+Run without installing the binary first:
 
 ```bash
 npx @slkiser/opencode-quota show
 ```
 
-Use `opencode-quota` directly when the package binary is already installed or on your `PATH`. Add `--provider` to show only one provider:
+Or, if `opencode-quota` is already on your `PATH`:
 
 ```bash
 opencode-quota show --provider copilot
 ```
 
-### Manual setup
+## What you get
 
-Add the server plugin to `opencode.json` or `opencode.jsonc`:
+- A `Quota` Sidebar panel in the TUI
+- Popup quota toasts in OpenCode
+- A Compact status line in the TUI
+- `/quota` and `/quota_status` slash commands
+- Token reports such as `/tokens_today` and `/tokens_weekly`
+- Provider diagnostics for auth, quota sources, and pricing
+
+<table>
+  <tr>
+    <td width="50%">
+      <img src="https://shawnkiser.com/opencode-quota/opencode-quota-sidebar.webp" alt="OpenCode Quota TUI sidebar panel" />
+    </td>
+    <td width="50%">
+      <img src="https://shawnkiser.com/opencode-quota/opencode-quota-toast.webp" alt="OpenCode Quota popup toast" />
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" align="center">Sidebar panel</td>
+    <td width="50%" align="center">Toast</td>
+  </tr>
+  <tr>
+    <td width="50%">
+      <img src="https://shawnkiser.com/opencode-quota/opencode-quota-statusbar.webp" alt="OpenCode Quota TUI status line" />
+    </td>
+    <td width="50%">
+      <img src="https://shawnkiser.com/opencode-quota/opencode-quota-tokens-command.webp" alt="OpenCode Quota token report" />
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" align="center">Compact status line</td>
+    <td width="50%" align="center"><code>/tokens_weekly</code> report</td>
+  </tr>
+</table>
+
+## Manual setup
+
+Use the installer when possible. For manual setup, use the same OpenCode config location you would pick in the installer:
+
+- **Project install:** files live in your repo/worktree.
+- **Global install:** files live in your OpenCode config directory, usually `~/.config/opencode`.
+- If you set `OPENCODE_CONFIG_DIR`, use that directory instead.
+
+### 1. Add the server plugin (required)
+
+This enables providers, slash commands, terminal checks, and popup toasts. Add this to `opencode.json` or `opencode.jsonc`:
 
 ```jsonc
 {
@@ -62,7 +118,9 @@ Add the server plugin to `opencode.json` or `opencode.jsonc`:
 }
 ```
 
-If you also want the sidebar, add the same package to the `tui.json` or `tui.jsonc` file that OpenCode loads:
+### 2. Add the TUI plugin (for Sidebar panel or Compact status line)
+
+If you want the Sidebar panel or Compact status line, also add this to `tui.json` or `tui.jsonc`:
 
 ```jsonc
 {
@@ -71,113 +129,103 @@ If you also want the sidebar, add the same package to the `tui.json` or `tui.jso
 }
 ```
 
-Quota settings go in `opencode-quota/quota-toast.json` next to the OpenCode config file you chose during install. Existing `experimental.quotaToast` settings still work when no sidecar file exists. Quota settings do not live in `tui.json`.
+### 3. Add quota settings
 
-<details>
-<summary><strong>Full configuration reference</strong></summary>
-
-#### Core/shared settings
-
-| Option                        | Default        | Meaning                                                                                                                                                                                                                                |
-| ----------------------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `enabled`                     | `true`         | Master switch for quota collection and handled slash commands. When `false`, `/quota`, `/quota_status`, `/pricing_refresh`, and `/tokens_*` are handled as no-ops.                                                                     |
-| `enabledProviders`            | `"auto"`       | Auto-detect providers, or set an explicit provider list. Unknown provider ids are reported under `config_errors` in `/quota_status`; an explicit list with no valid providers resolves to none instead of falling back to auto-detect. |
-| `minIntervalMs`               | `300000`       | Minimum fetch interval between provider updates.                                                                                                                                                                                       |
-| `requestTimeoutMs`            | `5000`         | Remote provider request timeout in milliseconds. Providers with custom defaults, such as Gemini CLI and OpenCode Go, keep their provider default unless this is explicitly configured.                                                 |
-| `formatStyle`                 | `singleWindow` | Shared quota-row style for popup toasts and the TUI sidebar: `singleWindow` or `allWindows`. Legacy `classic`/`grouped` aliases still work, and legacy `toastStyle` is still accepted on read for backward compatibility.              |
-| `percentDisplayMode`          | `remaining`    | Shared percent meaning for popup toasts and the TUI sidebar: `remaining` renders labels like `81% left`; `used` renders labels like `19% used` or `125% used` when over quota.                                                         |
-| `onlyCurrentModel`            | `false`        | Filter quota rows to the current model/provider when that session selection can be resolved.                                                                                                                                           |
-| `showSessionTokens`           | `true`         | Show the `Session input/output tokens` section in quota displays when session token data is available.                                                                                                                                 |
-| `pricingSnapshot.source`      | `"auto"`       | Token pricing snapshot selection for `/tokens_*`: `auto`, `bundled`, or `runtime`.                                                                                                                                                     |
-| `pricingSnapshot.autoRefresh` | `7`            | Refresh stale local pricing data after this many days.                                                                                                                                                                                 |
-
-`percentDisplayMode` affects popup toasts and the TUI sidebar only. `/quota` keeps its existing remaining-oriented percentage output.
-
-#### Toast settings
-
-| Option            | Default | Meaning                                                                         |
-| ----------------- | ------- | ------------------------------------------------------------------------------- |
-| `enableToast`     | `true`  | Show popup toasts. Disabling this does not disable `/quota` or the TUI sidebar. |
-| `toastDurationMs` | `9000`  | Toast duration in milliseconds.                                                 |
-| `showOnIdle`      | `true`  | Show a toast on the idle trigger.                                               |
-| `showOnQuestion`  | `true`  | Show a toast after a question/assistant response.                               |
-| `showOnCompact`   | `true`  | Show a toast after session compaction.                                          |
-| `showOnBothFail`  | `true`  | Show a fallback toast when providers attempted quota reads and all failed.      |
-| `layout.maxWidth` | `50`    | Toast formatting width target. Ignored by the TUI sidebar.                      |
-| `layout.narrowAt` | `42`    | Toast compact-layout breakpoint. Ignored by the TUI sidebar.                    |
-| `layout.tinyAt`   | `32`    | Toast tiny-layout breakpoint. Ignored by the TUI sidebar.                       |
-| `debug`           | `false` | Append toast debug context when troubleshooting.                                |
-
-#### TUI sidebar setup
-
-If you want the `Quota` sidebar panel, you need the plugin in both OpenCode config surfaces:
-
-| File                               | What goes there                       | Needed for sidebar?             |
-| ---------------------------------- | ------------------------------------- | ------------------------------- |
-| `tui.json` / `tui.jsonc`           | `plugin: ["@slkiser/opencode-quota"]` | Yes                             |
-| `opencode.json` / `opencode.jsonc` | Server plugin entry                   | Yes                             |
-| `opencode-quota/quota-toast.json`  | Quota settings                        | No, but controls quota behavior |
-
-#### Provider-specific settings
-
-| Option                       | Default                            | Meaning                                                                                              |
-| ---------------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------- |
-| `anthropicBinaryPath`        | `"claude"`                         | Command/path used for local Claude CLI probing; override this for custom installs or shim locations. |
-| `googleModels`               | `["CLAUDE"]`                       | Google model keys to query: `CLAUDE`, `G3PRO`, `G3FLASH`, `G3IMAGE`.                                 |
-| `opencodeGoWindows`          | `["rolling", "weekly", "monthly"]` | OpenCode Go usage windows to display.                                                                |
-| `alibabaCodingPlanTier`      | `"lite"`                           | Fallback Alibaba Coding Plan tier when auth does not include `tier`.                                 |
-| `cursorPlan`                 | `"none"`                           | Cursor included API budget preset: `none`, `pro`, `pro-plus`, `ultra`.                               |
-| `cursorIncludedApiUsd`       | unset                              | Override Cursor monthly included API budget in USD.                                                  |
-| `cursorBillingCycleStartDay` | unset                              | Local billing-cycle anchor day `1..28`; when unset, Cursor usage resets on the local calendar month. |
+Create or edit `opencode-quota/quota-toast.json` **next to the `opencode.json` / `tui.json` file above**. For a project install, that means:
 
-</details>
+```text
+<your-repo>/opencode-quota/quota-toast.json
+```
 
-### What opencode-quota adds
+Start with this, then adjust the UI choices in the next section:
 
-- TUI sidebar panel with quota rows
-- Popup quota toasts after assistant responses
-- Manual `/quota`, `/quota_status`, and `/tokens_*` commands
-- Terminal `opencode-quota show` command for a quota-only quick glance
-- Local token reports using bundled and runtime `models.dev` pricing
-- Custom quota tracking for companion plugins
+```jsonc
+{
+  "enabledProviders": "auto",
+  "enableToast": true,
+  "tuiSidebarPanel": {
+    "enabled": true,
+  },
+  "tuiCompactStatus": {
+    "enabled": false,
+  },
+}
+```
 
-<table>
-  <tr>
-    <td width="50%">
-      <img src="https://shawnkiser.com/opencode-quota/toast.webp" alt="OpenCode Quota popup toast" />
-    </td>
-    <td width="50%">
-      <img src="https://shawnkiser.com/opencode-quota/token.webp" alt="OpenCode Quota token report" />
-    </td>
-  </tr>
-  <tr>
-    <td width="50%" align="center">Popup quota toast</td>
-    <td width="50%" align="center"><code>/tokens_weekly</code> report</td>
-  </tr>
-</table>
+> [!TIP]
+> Run `/quota_status` to see the exact config paths OpenCode Quota loaded.
+
+## Choose your UI surfaces
+
+All UI surfaces use the same quota data. Put these settings in `opencode-quota/quota-toast.json`, not `tui.json`.
+
+| UI surface | Config | Notes |
+| --- | --- | --- |
+| Sidebar panel | `tuiSidebarPanel.enabled: true` | Full `Quota` panel in OpenCode's session sidebar. Requires the TUI plugin entry above. |
+| Toast | `enableToast: true` | Popup toast after idle/question/compact events. Requires the server plugin entry above. |
+| Compact status line | `tuiCompactStatus.enabled: true` | Short text-only quota line at the home bottom and chat/session prompt locations, for example `Copilot 94% | OpenAI Pro 5h 100%, 7d 100%`. Requires the TUI plugin entry above. |
+| Terminal/slash only | `enableToast: false`, `tuiSidebarPanel.enabled: false`, `tuiCompactStatus.enabled: false` | Keeps `/quota`, `/quota_status`, and terminal checks. |
+
+Selecting Compact status line in the installer enables both compact surfaces by default. To keep compact status home-only, set `tuiCompactStatus.sessionPrompt: false`.
+
+For more examples, see [Common configuration](#common-configuration). For every option, see [Full configuration reference](#full-configuration-reference).
+
+## Commands
+
+| Command | What it shows |
+| --- | --- |
+| `opencode-quota show` | Terminal quota-only quick glance |
+| `/quota` | Detailed quota report |
+| `/quota_status` | Config, provider, auth, pricing, and live probes |
+| `/pricing_refresh` | Refresh local runtime pricing from `models.dev` |
+| `/tokens_today` | Tokens used today |
+| `/tokens_daily` | Tokens used in the last 24 hours |
+| `/tokens_weekly` | Tokens used in the last 7 days |
+| `/tokens_monthly` | Tokens used in the last 30 days, including pricing |
+| `/tokens_all` | Tokens used across all local history |
+| `/tokens_session` | Tokens used in the current session |
+| `/tokens_session_all` | Current session plus descendant sessions |
+| `/tokens_between` | Tokens used between `YYYY-MM-DD YYYY-MM-DD` |
+
+## Providers
+
+Most providers work automatically. If a provider has a “Needs setup” link, open that setup note only if you use that provider.
+
+| Provider | Setup | Quota source |
+| --- | --- | --- |
+| Anthropic (Claude) | [Needs setup](#anthropic-claude) | Local CLI or OAuth usage |
+| GitHub Copilot | Usually automatic | Remote API |
+| OpenAI | Automatic | Remote API |
+| Cursor | [Needs setup](#cursor) | Local estimation |
+| Qwen Code | [Needs setup](#qwen-code) | Local estimation |
+| Alibaba Coding Plan | Automatic | Local estimation |
+| MiniMax Coding Plan | Automatic | Remote API |
+| MiniMax Coding Plan (CN) | Automatic | Remote API |
+| Kimi Code | Automatic | Remote API |
+| Chutes AI | Usually automatic | Remote API |
+| Crof.ai | Manual env/config | Remote API |
+| Synthetic | Automatic | Remote API |
+| Google Antigravity | [Needs setup](#google-antigravity) | Remote API |
+| Gemini CLI | [Needs setup](#gemini-cli) | Remote API |
+| Z.ai Coding Plan | Automatic | Remote API |
+| Zhipu Coding Plan | Automatic | Remote API |
+| NanoGPT | Usually automatic | Remote API |
+| OpenCode Go | [Needs setup](#opencode-go) | Dashboard scraping |
+
+## Common configuration
+
+Customize these settings in `opencode-quota/quota-toast.json`, next to the OpenCode config for your install scope.
+
+Common locations:
+
+- Project install: `<your-repo>/opencode-quota/quota-toast.json`
+- Global install: usually `~/.config/opencode/opencode-quota/quota-toast.json`
+- Custom config dir: `$OPENCODE_CONFIG_DIR/opencode-quota/quota-toast.json`
+
+If you are unsure, run `/quota_status`; it prints the config path it loaded.
 
-### Providers
-
-| Provider            | Auto setup?                                          | Setup / plugin order                                           | Quota source             |
-| ------------------- | ---------------------------------------------------- | -------------------------------------------------------------- | ------------------------ |
-| Anthropic (Claude)  | [Needs quick setup](#anthropic-claude-quick-setup)   | Install and authenticate Claude CLI                            | Local CLI or OAuth usage |
-| GitHub Copilot      | Usually automatic                                    | Existing OpenCode auth, or optional PAT config                 | Remote API               |
-| OpenAI              | Automatic                                            | Existing OpenCode OAuth                                        | Remote API               |
-| Cursor              | [Needs quick setup](#cursor-quick-setup)             | `["@playwo/opencode-cursor-oauth", "@slkiser/opencode-quota"]` | Local estimation         |
-| Qwen Code           | [Needs quick setup](#qwen-code-quick-setup)          | `["opencode-qwencode-auth", "@slkiser/opencode-quota"]`        | Local estimation         |
-| Alibaba Coding Plan | Automatic                                            | Existing OpenCode auth, global config, or env                  | Local estimation         |
-| MiniMax Coding Plan | Automatic                                            | Existing OpenCode auth, global config, or env                  | Remote API               |
-| Kimi Code           | Automatic                                            | Existing OpenCode auth, global config, or env                  | Remote API               |
-| Chutes AI           | Usually automatic                                    | Existing OpenCode auth, global config, or env                  | Remote API               |
-| Crof.ai             | Manual env/config                                    | `CROF_API_KEY`, `CROFAI_API_KEY`, or trusted user/global config | Remote API               |
-| Synthetic           | Automatic                                            | Existing OpenCode auth, global config, or env                  | Remote API               |
-| Google Antigravity  | [Needs quick setup](#google-antigravity-quick-setup) | `["opencode-antigravity-auth", "@slkiser/opencode-quota"]`     | Remote API               |
-| Gemini CLI          | [Needs quick setup](#gemini-cli-quick-setup)         | `["opencode-gemini-auth", "@slkiser/opencode-quota"]`          | Remote API               |
-| Z.ai Coding Plan    | Automatic                                            | Existing OpenCode auth, global config, or env                  | Remote API               |
-| NanoGPT             | Usually automatic                                    | Existing OpenCode auth, global config, or env                  | Remote API               |
-| OpenCode Go         | [Needs quick setup](#opencode-go-quick-setup)        | Set workspace ID and `auth` cookie                             | Dashboard scraping       |
-
-Providers are auto-detected by default. To choose providers explicitly, set `enabledProviders` in `opencode-quota/quota-toast.json`:
+<details>
+<summary><strong>Choose providers explicitly</strong></summary>
 
 ```jsonc
 {
@@ -185,14 +233,10 @@ Providers are auto-detected by default. To choose providers explicitly, set `ena
 }
 ```
 
-### Common Options
-
-Customize these settings in `opencode-quota/quota-toast.json`.
+</details>
 
 <details>
-<summary><strong>Show every quota window</strong></summary>
-
-Instead of the default most-constrained window:
+<summary><strong>Show all quota reset periods</strong></summary>
 
 ```jsonc
 {
@@ -203,48 +247,63 @@ Instead of the default most-constrained window:
 </details>
 
 <details>
-<summary><strong>Choose OpenCode Go windows</strong></summary>
-
-Choose which OpenCode Go windows to display:
+<summary><strong>Show used percentages</strong></summary>
 
 ```jsonc
 {
-  "opencodeGoWindows": ["rolling", "weekly", "monthly"],
+  "percentDisplayMode": "used",
 }
 ```
 
 </details>
 
 <details>
-<summary><strong>Show used percentages</strong></summary>
+<summary><strong>Turn off popup toasts</strong></summary>
 
-Show percentages as used instead of remaining in toasts and the sidebar:
+Keeps `/quota`, `/quota_status`, terminal checks, and any enabled UI surfaces.
 
 ```jsonc
 {
-  "percentDisplayMode": "used",
+  "enableToast": false,
 }
 ```
 
 </details>
 
 <details>
-<summary><strong>Turn off popup toasts</strong></summary>
+<summary><strong>Turn off the Sidebar panel</strong></summary>
 
-Keep `/quota` and the sidebar enabled:
+Useful when you want Compact status line only, toasts only, or slash commands only.
 
 ```jsonc
 {
-  "enableToast": false,
+  "tuiSidebarPanel": {
+    "enabled": false,
+  },
 }
 ```
 
 </details>
 
 <details>
-<summary><strong>Increase request timeout</strong></summary>
+<summary><strong>Keep Compact status line on home only</strong></summary>
 
-Increase the remote provider request timeout from the default 5000ms. Providers with custom defaults, such as Gemini CLI and OpenCode Go, keep their provider default unless you set this.
+Useful when you want the compact line on the home screen but not in the chat/session prompt area.
+
+```jsonc
+{
+  "tuiCompactStatus": {
+    "enabled": true,
+    "homeBottom": true,
+    "sessionPrompt": false,
+  },
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Increase provider request timeout</strong></summary>
 
 ```jsonc
 {
@@ -267,26 +326,75 @@ This is only for users who intentionally want `experimental.quotaToast` mirrored
 
 </details>
 
-### Commands
+## Full configuration reference
+
+Settings go in the same `opencode-quota/quota-toast.json` sidecar described above.
 
-| Command               | What it shows                                      |
-| --------------------- | -------------------------------------------------- |
-| `opencode-quota show` | Terminal quota-only quick glance                   |
-| `/quota`              | Detailed quota report                              |
-| `/quota_status`       | Config, provider, auth, pricing, and live probes   |
-| `/pricing_refresh`    | Refresh local runtime pricing from `models.dev`    |
-| `/tokens_today`       | Tokens used today                                  |
-| `/tokens_daily`       | Tokens used in the last 24 hours                   |
-| `/tokens_weekly`      | Tokens used in the last 7 days                     |
-| `/tokens_monthly`     | Tokens used in the last 30 days, including pricing |
-| `/tokens_all`         | Tokens used across all local history               |
-| `/tokens_session`     | Tokens used in the current session                 |
-| `/tokens_session_all` | Current session plus descendant sessions           |
-| `/tokens_between`     | Tokens used between `YYYY-MM-DD YYYY-MM-DD`        |
+Existing `experimental.quotaToast` settings still work when no sidecar file exists. Quota settings do not live in `tui.json`.
 
-<a id="anthropic-claude-quick-setup"></a>
+<details>
+<summary><strong>All settings</strong></summary>
+
+### Core/shared settings
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `enabled` | `true` | Master switch for quota collection and handled slash commands. When `false`, `/quota`, `/quota_status`, `/pricing_refresh`, and `/tokens_*` are handled as no-ops. |
+| `enabledProviders` | `"auto"` | Auto-detect providers, or set an explicit provider list. |
+| `minIntervalMs` | `300000` | Minimum fetch interval between provider updates. |
+| `requestTimeoutMs` | `5000` | Remote provider request timeout in milliseconds. |
+| `formatStyle` | `singleWindow` | Shared quota reset-period display for popup toasts and the Sidebar panel: `singleWindow` shows one reset period per provider; `allWindows` shows all reset periods per provider. Legacy `classic`/`grouped` aliases are still accepted. |
+| `percentDisplayMode` | `remaining` | Shared quota percentage meaning for popup toasts and the Sidebar panel: `remaining` shows quota left; `used` shows quota consumed. `/quota` keeps its existing remaining-percent output. |
+| `onlyCurrentModel` | `false` | Filter quota rows to the current model/provider when that session selection can be resolved. |
+| `showSessionTokens` | `true` | Show the `Session input/output tokens` section when session token data is available. When cached input is present, the section keeps the legacy `in/out` layout and appends cached input in parentheses next to the input amount. |
+| `pricingSnapshot.source` | `"auto"` | Token pricing snapshot selection for `/tokens_*`: `auto`, `bundled`, or `runtime`. |
+| `pricingSnapshot.autoRefresh` | `7` | Refresh stale local pricing data after this many days. |
+
+### Toast settings
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `enableToast` | `true` | Show popup toasts. Disabling this does not disable `/quota` or UI surfaces. |
+| `toastDurationMs` | `9000` | Toast duration in milliseconds. |
+| `showOnIdle` | `true` | Show a toast on the idle trigger. |
+| `showOnQuestion` | `true` | Show a toast after a question/assistant response. |
+| `showOnCompact` | `true` | Show a toast after session compaction. |
+| `showOnBothFail` | `true` | Show a fallback toast when providers attempted quota reads and all failed. |
+| `layout.maxWidth` | `50` | Toast formatting width target. |
+| `layout.narrowAt` | `42` | Toast compact-layout breakpoint. |
+| `layout.tinyAt` | `32` | Toast tiny-layout breakpoint. |
+| `debug` | `false` | Append toast debug context when troubleshooting. |
+
+### TUI settings
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `tuiSidebarPanel.enabled` | `true` | Show the Sidebar `Quota` panel when the TUI plugin is installed. Default is `true` for backward compatibility. |
+| `tuiCompactStatus.enabled` | `false` | Opt in to Compact status line UI surfaces. |
+| `tuiCompactStatus.homeBottom` | `true` | Show the Compact status line at the home bottom location. |
+| `tuiCompactStatus.sessionPrompt` | `true` | Show the Compact status line by wrapping the TUI session prompt. Disable this if you only want the home-bottom line. |
+| `tuiCompactStatus.suppressWhenNativeProviderQuota` | `true` | Hide the Compact status line when OpenCode exposes native provider-quota support. |
+| `tuiCompactStatus.maxWidth` | `96` | Maximum Compact status line text width. |
+
+### Provider-specific settings
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `anthropicBinaryPath` | `"claude"` | Command/path used for local Claude CLI probing. |
+| `googleModels` | `["CLAUDE"]` | Google model keys to query: `CLAUDE`, `G3PRO`, `G3FLASH`, `G3IMAGE`. |
+| `opencodeGoWindows` | `["rolling", "weekly", "monthly"]` | OpenCode Go usage windows to display. |
+| `alibabaCodingPlanTier` | `"lite"` | Fallback Alibaba Coding Plan tier when auth does not include `tier`. |
+| `cursorPlan` | `"none"` | Cursor included API budget preset: `none`, `pro`, `pro-plus`, `ultra`. |
+| `cursorIncludedApiUsd` | unset | Override Cursor monthly included API budget in USD. |
+| `cursorBillingCycleStartDay` | unset | Local billing-cycle anchor day `1..28`; when unset, Cursor usage resets on the local calendar month. |
 
-### Anthropic quick setup
+</details>
+
+## Provider setup notes
+
+<a id="anthropic-claude"></a>
+<details>
+<summary><strong>Anthropic (Claude)</strong></summary>
 
 Install Claude Code, authenticate it, and make sure `claude` is on your `PATH`:
 
@@ -297,82 +405,41 @@ claude auth status
 
 If Claude lives at a custom path, set `anthropicBinaryPath` in `opencode-quota/quota-toast.json`.
 
-### Companion providers
-
-Some providers need an auth companion plugin. Add the companion plugin first and `@slkiser/opencode-quota` second.
-
-<a id="cursor-quick-setup"></a>
-
-#### Cursor
-
-Companion plugin: [`@playwo/opencode-cursor-oauth`](https://github.com/PoolPirate/opencode-cursor#readme)
-
-Add both plugins to `opencode.json`, with the Cursor auth plugin first:
+</details>
 
-```jsonc
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["@playwo/opencode-cursor-oauth", "@slkiser/opencode-quota"],
-  "provider": {
-    "cursor": {
-      "name": "Cursor",
-    },
-  },
-}
-```
+<a id="cursor"></a>
+<details>
+<summary><strong>Cursor</strong></summary>
 
-Then authenticate Cursor once:
+Use companion plugin [`@playwo/opencode-cursor-oauth`](https://github.com/PoolPirate/opencode-cursor#readme). Add it before `@slkiser/opencode-quota` in `opencode.json`, then authenticate once:
 
 ```bash
 opencode auth login --provider cursor
 ```
 
-<a id="qwen-code-quick-setup"></a>
-
-#### Qwen Code
-
-Companion plugin: [`opencode-qwencode-auth`](https://github.com/gustavodiasdev/opencode-qwencode-auth#readme)
-
-Add both plugins to `opencode.json`, with the Qwen auth plugin first:
-
-```jsonc
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["opencode-qwencode-auth", "@slkiser/opencode-quota"],
-}
-```
-
-<a id="google-antigravity-quick-setup"></a>
-
-#### Google Antigravity
-
-Companion plugin: [`opencode-antigravity-auth`](https://github.com/NoeFabris/opencode-antigravity-auth#readme)
+</details>
 
-Add both plugins to `opencode.json`, with the Antigravity auth plugin first:
+<a id="qwen-code"></a>
+<details>
+<summary><strong>Qwen Code</strong></summary>
 
-```jsonc
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["opencode-antigravity-auth", "@slkiser/opencode-quota"],
-}
-```
+Use companion plugin [`opencode-qwencode-auth`](https://github.com/gustavodiasdev/opencode-qwencode-auth#readme). Add it before `@slkiser/opencode-quota` in `opencode.json`.
 
-<a id="gemini-cli-quick-setup"></a>
+</details>
 
-#### Gemini CLI
+<a id="google-antigravity"></a>
+<details>
+<summary><strong>Google Antigravity</strong></summary>
 
-Companion plugin: [`opencode-gemini-auth`](https://github.com/jenslys/opencode-gemini-auth#readme)
+Use companion plugin [`opencode-antigravity-auth`](https://github.com/NoeFabris/opencode-antigravity-auth#readme). Add it before `@slkiser/opencode-quota` in `opencode.json`.
 
-Add both plugins to `opencode.json`, with the Gemini auth plugin first:
+</details>
 
-```jsonc
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["opencode-gemini-auth", "@slkiser/opencode-quota"],
-}
-```
+<a id="gemini-cli"></a>
+<details>
+<summary><strong>Gemini CLI</strong></summary>
 
-Then authenticate Google once:
+Use companion plugin [`opencode-gemini-auth`](https://github.com/jenslys/opencode-gemini-auth#readme). Add it before `@slkiser/opencode-quota` in `opencode.json`, then authenticate Google once:
 
 ```bash
 opencode auth login --provider google
@@ -380,9 +447,11 @@ opencode auth login --provider google
 
 If you use manual provider selection, include `google-gemini-cli` in `enabledProviders`.
 
-### OpenCode Go
+</details>
 
-<a id="opencode-go-quick-setup"></a>
+<a id="opencode-go"></a>
+<details>
+<summary><strong>OpenCode Go</strong></summary>
 
 OpenCode Go quota scrapes the dashboard and needs a workspace ID plus an `auth` cookie:
 
@@ -391,36 +460,46 @@ export OPENCODE_GO_WORKSPACE_ID="your-workspace-id"
 export OPENCODE_GO_AUTH_COOKIE="your-auth-cookie"
 ```
 
-OpenCode Go can show **5h**, **Weekly**, and **Monthly** windows. Use `opencodeGoWindows` in `opencode-quota/quota-toast.json` to choose a subset.
+Use `opencodeGoWindows` to choose **5h**, **Weekly**, and/or **Monthly** windows. Environment variables take precedence over the optional `opencode-go.json` file.
 
-Environment variables take precedence over the optional `opencode-go.json` file. Run `/quota_status` to see the exact paths checked.
+</details>
 
-### Troubleshooting
+## Troubleshooting
 
-If quota or token data looks wrong:
+Start here when quota or token data looks wrong.
 
 1. Run `/quota_status`.
 2. Confirm the expected provider appears in the detected provider list.
-3. Confirm OpenCode has already created `opencode.db` if token reports are empty.
-4. Check companion plugins for Cursor, Qwen Code, Google Antigravity, and Gemini CLI.
-5. Use the quick-setup link in the provider table for provider-specific auth and config notes.
+3. Confirm companion auth plugins are before `@slkiser/opencode-quota` in `opencode.json`.
+4. If token reports are empty, start OpenCode once so it creates `opencode.db`, then run a session with model usage.
+5. Use the provider-specific table below for the failing provider.
+
+### Common symptoms
 
-### Provider Troubleshooting
+| Symptom | Try this |
+| --- | --- |
+| `/quota` shows no providers | Run `/quota_status`, then check provider detection and auth. |
+| Sidebar panel does not appear | Confirm `tui.json` includes `@slkiser/opencode-quota`, restart OpenCode, and check `tuiSidebarPanel.enabled`. |
+| Compact status line does not appear anywhere | Confirm `tui.json` includes `@slkiser/opencode-quota`, restart OpenCode, check `tuiCompactStatus.enabled`, and check whether `tuiCompactStatus.suppressWhenNativeProviderQuota` is hiding it because OpenCode exposes native provider-quota support. |
+| Compact status appears on home but not in chat/session | Check `tuiCompactStatus.sessionPrompt`; set it to `true` to show the chat/session prompt line. |
+| Popup toasts do not appear | Check `enableToast`, `showOnIdle`, `showOnQuestion`, and `showOnCompact`. |
+| Token reports are empty | Start OpenCode once so `opencode.db` exists, then run a session with model usage. |
+| Pricing looks stale | Run `/pricing_refresh`. |
 
-For companion providers, confirm the auth plugin appears before `@slkiser/opencode-quota` in `opencode.json`.
+### Provider troubleshooting
 
 <details>
 <summary><strong>Anthropic (Claude)</strong></summary>
 
 Run `/quota_status` and check the Anthropic section.
 
-| Symptom                              | Fix                                                                                                                                 |
-| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
-| `claude` not found                   | Install Claude Code and make sure `claude` is on your `PATH`.                                                                       |
-| Claude is installed at a custom path | Set `anthropicBinaryPath` in `opencode-quota/quota-toast.json`.                                                                     |
-| Not authenticated                    | Run `claude auth login`, then confirm `claude auth status` works.                                                                   |
-| Auth works but no quota rows appear  | Check `quota_source` and `message` in `/quota_status`; re-authenticate Claude if the OAuth credential fallback is missing or stale. |
-| Provider not detected                | Confirm OpenCode is configured to use the `anthropic` provider.                                                                     |
+| Symptom | Fix |
+| --- | --- |
+| `claude` not found | Install Claude Code and make sure `claude` is on your `PATH`. |
+| Claude is installed at a custom path | Set `anthropicBinaryPath` in `opencode-quota/quota-toast.json`. |
+| Not authenticated | Run `claude auth login`, then confirm `claude auth status` works. |
+| Auth works but no quota rows appear | Check `quota_source` and `message` in `/quota_status`; re-authenticate Claude if the OAuth credential fallback is missing or stale. |
+| Provider not detected | Confirm OpenCode is configured to use the `anthropic` provider. |
 
 </details>
 
@@ -429,12 +508,12 @@ Run `/quota_status` and check the Anthropic section.
 
 Run `/quota_status` and check `copilot_quota_auth`, `billing_mode`, `billing_scope`, and `quota_api`.
 
-| Symptom                              | Fix                                                                                                                                         |
-| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
-| Personal quota missing               | Confirm OpenCode Copilot auth works. The plugin can read OpenCode's Copilot OAuth token.                                                    |
-| Business or Enterprise quota missing | Add `copilot-quota-token.json` in the OpenCode runtime config directory shown by `opencode debug paths`.                                    |
-| PAT config exists but quota fails    | Fix `copilot-quota-token.json`; when present, it takes precedence over OAuth and does not silently fall back.                               |
-| Enterprise usage missing             | Use a classic PAT with the required billing access. Fine-grained PATs and GitHub App tokens are not supported for Enterprise premium usage. |
+| Symptom | Fix |
+| --- | --- |
+| Personal quota missing | Confirm OpenCode Copilot auth works. The plugin can read OpenCode's Copilot OAuth token. |
+| Business or Enterprise quota missing | Add `copilot-quota-token.json` in the OpenCode runtime config directory shown by `opencode debug paths`. |
+| PAT config exists but quota fails | Fix `copilot-quota-token.json`; when present, it takes precedence over OAuth and does not silently fall back. |
+| Enterprise usage missing | Use a classic PAT with the required billing access. Fine-grained PATs and GitHub App tokens are not supported for Enterprise premium usage. |
 
 </details>
 
@@ -443,10 +522,10 @@ Run `/quota_status` and check `copilot_quota_auth`, `billing_mode`, `billing_sco
 
 Run `/quota_status` and check the OpenAI auth source and token status.
 
-| Symptom               | Fix                                                                                        |
-| --------------------- | ------------------------------------------------------------------------------------------ |
-| OpenAI quota missing  | Confirm OpenCode native OpenAI OAuth is present in `auth.json`.                            |
-| Token expired         | Re-run OpenCode's OpenAI auth flow.                                                        |
+| Symptom | Fix |
+| --- | --- |
+| OpenAI quota missing | Confirm OpenCode native OpenAI OAuth is present in `auth.json`. |
+| Token expired | Re-run OpenCode's OpenAI auth flow. |
 | Provider not detected | Confirm your OpenCode config uses the `openai` provider or a compatible OpenAI auth entry. |
 
 </details>
@@ -456,13 +535,13 @@ Run `/quota_status` and check the OpenAI auth source and token status.
 
 Run `/quota_status` and check the Cursor section.
 
-| Symptom                                   | Fix                                                                                                     |
-| ----------------------------------------- | ------------------------------------------------------------------------------------------------------- |
-| Cursor not detected                       | Put `@playwo/opencode-cursor-oauth` before `@slkiser/opencode-quota` in `opencode.json`.                |
-| Cursor auth missing                       | Run `opencode auth login --provider cursor`.                                                            |
-| Quota appears but no remaining percentage | Set `cursorPlan` or `cursorIncludedApiUsd` in `opencode-quota/quota-toast.json`.                        |
-| Billing cycle looks wrong                 | Set `cursorBillingCycleStartDay` in `opencode-quota/quota-toast.json` to your local billing anchor day. |
-| Unknown Cursor pricing                    | Run `/pricing_refresh`; if still unknown, check `/quota_status` for unknown model ids.                  |
+| Symptom | Fix |
+| --- | --- |
+| Cursor not detected | Put `@playwo/opencode-cursor-oauth` before `@slkiser/opencode-quota` in `opencode.json`. |
+| Cursor auth missing | Run `opencode auth login --provider cursor`. |
+| Quota appears but no remaining percentage | Set `cursorPlan` or `cursorIncludedApiUsd` in `opencode-quota/quota-toast.json`. |
+| Billing cycle looks wrong | Set `cursorBillingCycleStartDay` in `opencode-quota/quota-toast.json` to your local billing anchor day. |
+| Unknown Cursor pricing | Run `/pricing_refresh`; if still unknown, check `/quota_status` for unknown model ids. |
 
 </details>
 
@@ -471,12 +550,12 @@ Run `/quota_status` and check the Cursor section.
 
 Run `/quota_status` and check `qwen_oauth_source`, `qwen_local_plan`, and the `qwen_code` live probe section.
 
-| Symptom              | Fix                                                                                                          |
-| -------------------- | ------------------------------------------------------------------------------------------------------------ |
-| Qwen not detected    | Put `opencode-qwencode-auth` before `@slkiser/opencode-quota` in `opencode.json`.                            |
-| Auth missing         | Complete the Qwen companion plugin auth flow.                                                                |
+| Symptom | Fix |
+| --- | --- |
+| Qwen not detected | Put `opencode-qwencode-auth` before `@slkiser/opencode-quota` in `opencode.json`. |
+| Auth missing | Complete the Qwen companion plugin auth flow. |
 | Counters do not move | Confirm the current model is `qwen-code/*`; Qwen quota is local request estimation for matching model usage. |
-| Usage looks stale    | Check the local state file path shown by `/quota_status`.                                                    |
+| Usage looks stale | Check the local state file path shown by `/quota_status`. |
 
 </details>
 
@@ -485,29 +564,31 @@ Run `/quota_status` and check `qwen_oauth_source`, `qwen_local_plan`, and the `q
 
 Run `/quota_status` and check the Alibaba auth, resolved tier, state-file path, and `alibaba_coding_plan` live probe section.
 
-| Symptom              | Fix                                                                                                                                                   |
-| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Symptom | Fix |
+| --- | --- |
 | API key not detected | Use `ALIBABA_CODING_PLAN_API_KEY`, `ALIBABA_API_KEY`, trusted user/global OpenCode config, or OpenCode auth. Repo-local provider secrets are ignored. |
-| Wrong tier           | Set `alibabaCodingPlanTier` to `lite` or `pro` in `opencode-quota/quota-toast.json`.                                                                  |
-| Counters do not move | Confirm the current model is `alibaba/*` or `alibaba-cn/*`.                                                                                           |
-| Quota seems stale    | Check the state-file path shown in `/quota_status`.                                                                                                   |
+| Wrong tier | Set `alibabaCodingPlanTier` to `lite` or `pro` in `opencode-quota/quota-toast.json`. |
+| Counters do not move | Confirm the current model is `alibaba/*` or `alibaba-cn/*`. |
+| Quota seems stale | Check the state-file path shown in `/quota_status`. |
 
 </details>
 
 <details>
-<summary><strong>MiniMax, Kimi, Chutes AI, Crof.ai, Synthetic, Z.ai, and NanoGPT</strong></summary>
-
-These providers use trusted env vars, trusted user/global OpenCode config, or native OpenCode auth. Run `/quota_status` and check the provider-specific API-key diagnostics (Crof.ai is env/config only).
-
-| Provider            | Useful checks                                                                                         |
-| ------------------- | ----------------------------------------------------------------------------------------------------- |
-| MiniMax Coding Plan | Use `MINIMAX_CODING_PLAN_API_KEY` or `MINIMAX_API_KEY`; repo-local provider secrets are ignored.      |
-| Kimi Code           | Use `KIMI_API_KEY` or `KIMI_CODE_API_KEY`; repo-local provider secrets are ignored.                   |
-| Chutes AI           | Use `CHUTES_API_KEY` or trusted user/global config.                                                   |
-| Crof.ai             | Use `CROF_API_KEY`, `CROFAI_API_KEY`, or trusted user/global config.                              |
-| Synthetic           | Use `SYNTHETIC_API_KEY`, trusted user/global config, or OpenCode auth.                                |
-| Z.ai Coding Plan    | Use `ZAI_API_KEY` or `ZAI_CODING_PLAN_API_KEY`; malformed fallback auth is surfaced as an auth error. |
-| NanoGPT             | Use `NANOGPT_API_KEY`, `NANO_GPT_API_KEY`, trusted user/global config, or OpenCode auth.              |
+<summary><strong>MiniMax, Kimi, Chutes AI, Crof.ai, Synthetic, Z.ai, Zhipu, and NanoGPT</strong></summary>
+
+These providers use trusted env vars, trusted user/global OpenCode config, or native OpenCode auth. Run `/quota_status` and check the provider-specific API-key diagnostics. Crof.ai is env/config only.
+
+| Provider | Useful checks |
+| --- | --- |
+| MiniMax Coding Plan | Use `MINIMAX_CODING_PLAN_API_KEY` or `MINIMAX_API_KEY` for the international endpoint. Runtime/config ids like `minimax` and `minimax-coding-plan` use this provider. Repo-local provider secrets are ignored. |
+| MiniMax Coding Plan (CN) | Use `MINIMAX_CHINA_CODING_PLAN_API_KEY` or trusted user/global OpenCode config under `minimax-china-coding-plan`, `minimax-cn-coding-plan`, `minimax-cn`, or `minimax-china`. Runtime id `minimax-cn-coding-plan` uses this provider. |
+| Kimi Code | Use `KIMI_API_KEY` or `KIMI_CODE_API_KEY`; repo-local provider secrets are ignored. |
+| Chutes AI | Use `CHUTES_API_KEY` or trusted user/global config. |
+| Crof.ai | Use `CROF_API_KEY`, `CROFAI_API_KEY`, or trusted user/global config. |
+| Synthetic | Use `SYNTHETIC_API_KEY`, trusted user/global config, or OpenCode auth. |
+| Z.ai Coding Plan | Use `ZAI_API_KEY` or `ZAI_CODING_PLAN_API_KEY`; malformed fallback auth is surfaced as an auth error. |
+| Zhipu Coding Plan | Use `ZHIPU_API_KEY` or `ZHIPU_CODING_PLAN_API_KEY`; malformed fallback auth is surfaced as an auth error. |
+| NanoGPT | Use `NANOGPT_API_KEY`, `NANO_GPT_API_KEY`, trusted user/global config, or OpenCode auth. |
 
 For security, repo-local `opencode.json` / `opencode.jsonc` is ignored for provider secrets in these integrations. Put secrets in environment variables or trusted user/global config.
 
@@ -518,12 +599,12 @@ For security, repo-local `opencode.json` / `opencode.jsonc` is ignored for provi
 
 Run `/quota_status` and check the `google_antigravity` section.
 
-| Symptom                  | Fix                                                                                  |
-| ------------------------ | ------------------------------------------------------------------------------------ |
-| Companion missing        | Put `opencode-antigravity-auth` before `@slkiser/opencode-quota` in `opencode.json`. |
-| Accounts not found       | Check the selected `antigravity-accounts.json` path shown by `/quota_status`.        |
-| Refresh tokens invalid   | Re-authenticate with the companion plugin.                                           |
-| Provider returns no rows | Check `live_probe`, `live_entry_*`, and `live_error_*` in `/quota_status`.           |
+| Symptom | Fix |
+| --- | --- |
+| Companion missing | Put `opencode-antigravity-auth` before `@slkiser/opencode-quota` in `opencode.json`. |
+| Accounts not found | Check the selected `antigravity-accounts.json` path shown by `/quota_status`. |
+| Refresh tokens invalid | Re-authenticate with the companion plugin. |
+| Provider returns no rows | Check `live_probe`, `live_entry_*`, and `live_error_*` in `/quota_status`. |
 
 </details>
 
@@ -532,12 +613,12 @@ Run `/quota_status` and check the `google_antigravity` section.
 
 Run `/quota_status` and check the Gemini CLI live probe rows.
 
-| Symptom                             | Fix                                                                                                                          |
-| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
-| Companion missing                   | Put `opencode-gemini-auth` before `@slkiser/opencode-quota` in `opencode.json`.                                              |
-| Provider not enabled in manual mode | Include `google-gemini-cli` in `enabledProviders` in `opencode-quota/quota-toast.json`.                                      |
-| Auth missing                        | Run `opencode auth login --provider google`.                                                                                 |
-| Project missing                     | Set `provider.google.options.projectId`, `OPENCODE_GEMINI_PROJECT_ID`, `GOOGLE_CLOUD_PROJECT`, or `GOOGLE_CLOUD_PROJECT_ID`. |
+| Symptom | Fix |
+| --- | --- |
+| Companion missing | Put `opencode-gemini-auth` before `@slkiser/opencode-quota` in `opencode.json`. |
+| Provider not enabled in manual mode | Include `google-gemini-cli` in `enabledProviders` in `opencode-quota/quota-toast.json`. |
+| Auth missing | Run `opencode auth login --provider google`. |
+| Project missing | Set `provider.google.options.projectId`, `OPENCODE_GEMINI_PROJECT_ID`, `GOOGLE_CLOUD_PROJECT`, or `GOOGLE_CLOUD_PROJECT_ID`. |
 
 </details>
 
@@ -546,42 +627,42 @@ Run `/quota_status` and check the Gemini CLI live probe rows.
 
 Run `/quota_status` and check the `opencode_go` section.
 
-| Symptom                  | Fix                                                                                                                                                                                            |
-| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Config not detected      | Set both `OPENCODE_GO_WORKSPACE_ID` and `OPENCODE_GO_AUTH_COOKIE`, then rerun `/quota_status`.                                                                                                 |
-| Incomplete config        | `workspaceId` and `authCookie` must come from the same source.                                                                                                                                 |
-| Scrape returns no data   | Refresh the browser `auth` cookie from `opencode.ai`.                                                                                                                                          |
-| Selected window missing  | Check `/quota_status` for `selected_windows` and `live_fetch_error`; remove unavailable windows from `opencodeGoWindows` in `opencode-quota/quota-toast.json` or refresh the dashboard cookie. |
-| Dashboard format changed | This integration scrapes the dashboard, so it can break if the dashboard markup changes.                                                                                                       |
+| Symptom | Fix |
+| --- | --- |
+| Config not detected | Set both `OPENCODE_GO_WORKSPACE_ID` and `OPENCODE_GO_AUTH_COOKIE`, then rerun `/quota_status`. |
+| Incomplete config | `workspaceId` and `authCookie` must come from the same source. |
+| Scrape returns no data | Refresh the browser `auth` cookie from `opencode.ai`. |
+| Selected window missing | Check `/quota_status` for `selected_windows` and `live_fetch_error`; remove unavailable windows from `opencodeGoWindows` in `opencode-quota/quota-toast.json` or refresh the dashboard cookie. |
+| Dashboard format changed | This integration scrapes the dashboard, so it can break if the dashboard markup changes. |
 
 </details>
 
 <details>
-<summary><strong>Token Reports</strong></summary>
+<summary><strong>Token reports</strong></summary>
 
 Run `/quota_status` and check pricing snapshot health plus OpenCode database paths.
 
-| Symptom                                | Fix                                                                                                           |
-| -------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
-| `/tokens_*` is empty                   | Start OpenCode once so it creates `opencode.db`, then run a session with model usage.                         |
-| Pricing looks stale                    | Run `/pricing_refresh`.                                                                                       |
+| Symptom | Fix |
+| --- | --- |
+| `/tokens_*` is empty | Start OpenCode once so it creates `opencode.db`, then run a session with model usage. |
+| Pricing looks stale | Run `/pricing_refresh`. |
 | Runtime pricing does not change output | Check `pricingSnapshot.source` in `opencode-quota/quota-toast.json`; `bundled` keeps packaged pricing active. |
-| Cursor model has unknown pricing       | Run `/pricing_refresh`; Cursor `auto` and `composer*` use bundled deterministic pricing.                      |
+| Cursor model has unknown pricing | Run `/pricing_refresh`; Cursor `auto` and `composer*` use bundled deterministic pricing. |
 
 </details>
 
-### Issues
+## Issues
 
 Please use the Bug report or Feature request templates when opening issues. Freeform issues, or bug/feature issues missing the required template sections, may be automatically commented on and closed.
 
-### License
+## License
 
 MIT
 
-### Remarks
+## Remarks
 
 OpenCode Quota is not built by the OpenCode team and is not affiliated with OpenCode or any provider listed above.
 
-### Star History
+## Star history
 
 [![Star History Chart](https://api.star-history.com/chart?repos=slkiser/opencode-quota&type=date&legend=bottom-right)](https://www.star-history.com/?repos=slkiser%2Fopencode-quota&type=date&legend=bottom-right)