@slkiser/opencode-quota 3.5.0 → 3.6.1

package/README.md

@@ -19,7 +19,7 @@
 
 ---
 
-### Installation (automatic setup)
+### Quick start
 
 ```bash
 npx @slkiser/opencode-quota init
@@ -28,24 +28,28 @@ npx @slkiser/opencode-quota init
 > [!IMPORTANT]
 > OpenCode `>= 1.4.3` and Node.js `>= 18` are required.
 
-The installer is append-only and preserves existing config values. It asks where to install, which quota UI to enable, whether providers should be auto-detected, which quota display style to use, how percentages should be labeled, and whether session input/output tokens should appear in quota displays. By default it writes quota settings to `opencode-quota/quota-toast.json` only; if you also need the legacy OpenCode `experimental.quotaToast` block, run `npx @slkiser/opencode-quota init --sync-legacy-config`.
+The installer is append-only: it adds the plugin, asks a few display/provider questions, and leaves existing values alone.
 
 After install:
 
 1. Restart OpenCode.
-2. Run `/quota_status`.
-3. Run `/quota`.
-4. If you enabled the sidebar, open the session sidebar and confirm the `Quota` panel appears.
+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.
 
-For a terminal-only quota glance:
+Terminal-only check:
+
+Use `npx` when you want to run the published package without installing the binary first:
 
 ```bash
 npx @slkiser/opencode-quota show
-# or, if installed/on PATH:
-opencode-quota show --provider copilot
 ```
 
-`show` is quota-only: no token/cost reports or `models.dev` refresh. Installer `None (commands and terminal only)` disables toast/sidebar but keeps `/quota`, `/tokens_*`, and terminal `show`.
+Use `opencode-quota` directly when the package binary is already installed or on your `PATH`. Add `--provider` to show only one provider:
+
+```bash
+opencode-quota show --provider copilot
+```
 
 ### Manual setup
 
@@ -67,9 +71,68 @@ If you also want the sidebar, add the same package to the `tui.json` or `tui.jso
 }
 ```
 
-Quota settings live in `opencode-quota/quota-toast.json` next to the OpenCode config file chosen by the installer (project or global). On load, OpenCode Quota reads that sidecar first and falls back to existing `experimental.quotaToast` settings in `opencode.json` / `opencode.jsonc` only when the sidecar is absent. Normal runtime/load does not create, re-add, or migrate `experimental.quotaToast`; use `init --sync-legacy-config` when you explicitly want the installer to also write/sync that legacy block. Quota settings do not live in `tui.json`.
+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`.
+
+<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. |
+
+</details>
 
-### What plugin adds
+### What opencode-quota adds
 
 - TUI sidebar panel with quota rows
 - Popup quota toasts after assistant responses
@@ -95,73 +158,115 @@ Quota settings live in `opencode-quota/quota-toast.json` next to the OpenCode co
 
 ### 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 auth                                    | 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               |
-| 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       |
-
-For companion auth providers, put the companion plugin first and `@slkiser/opencode-quota` second. The companion plugin handles login or token storage; OpenCode Quota reads that auth state and renders quota.
-
-Providers are auto-detected by default. To choose providers explicitly:
+| 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` 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`:
 
 ```jsonc
-// opencode-quota/quota-toast.json
 {
   "enabledProviders": ["copilot", "openai", "google-gemini-cli"],
 }
 ```
 
-### Display options
+### Common Options
 
-Show every quota window instead of the default most-constrained window:
+Customize these settings in `opencode-quota/quota-toast.json`.
+
+<details>
+<summary><strong>Show every quota window</strong></summary>
+
+Instead of the default most-constrained window:
 
 ```jsonc
-// opencode-quota/quota-toast.json
 {
   "formatStyle": "allWindows",
 }
 ```
 
-Choose which OpenCode Go usage windows to display (default is all three; `rolling` displays as `5h`):
+</details>
+
+<details>
+<summary><strong>Choose OpenCode Go windows</strong></summary>
+
+Choose which OpenCode Go windows to display:
 
 ```jsonc
-// opencode-quota/quota-toast.json
 {
   "opencodeGoWindows": ["rolling", "weekly", "monthly"],
 }
 ```
 
+</details>
+
+<details>
+<summary><strong>Show used percentages</strong></summary>
+
 Show percentages as used instead of remaining in toasts and the sidebar:
 
 ```jsonc
-// opencode-quota/quota-toast.json
 {
   "percentDisplayMode": "used",
 }
 ```
 
-Turn off popup toasts while keeping `/quota` and the sidebar:
+</details>
+
+<details>
+<summary><strong>Turn off popup toasts</strong></summary>
+
+Keep `/quota` and the sidebar enabled:
 
 ```jsonc
-// opencode-quota/quota-toast.json
 {
   "enableToast": false,
 }
 ```
 
+</details>
+
+<details>
+<summary><strong>Increase request timeout</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.
+
+```jsonc
+{
+  "requestTimeoutMs": 12000,
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Advanced: legacy config sync</strong></summary>
+
+By default, the installer writes quota settings only to `opencode-quota/quota-toast.json`. If you also want it to write the legacy OpenCode block, run:
+
+```bash
+npx @slkiser/opencode-quota init --sync-legacy-config
+```
+
+This is only for users who intentionally want `experimental.quotaToast` mirrored into `opencode.json` / `opencode.jsonc`.
+
+</details>
+
 ### Commands
 
 | Command               | What it shows                                      |
@@ -183,7 +288,7 @@ Turn off popup toasts while keeping `/quota` and the sidebar:
 
 ### Anthropic quick setup
 
-Anthropic does not use a companion OpenCode plugin. Install Claude Code, authenticate it, and make sure `claude` is available on your `PATH`:
+Install Claude Code, authenticate it, and make sure `claude` is on your `PATH`:
 
 ```bash
 claude auth login
@@ -194,7 +299,7 @@ If Claude lives at a custom path, set `anthropicBinaryPath` in `opencode-quota/q
 
 ### Companion providers
 
-Some providers need an auth companion plugin installed separately. Add the companion plugin first and `@slkiser/opencode-quota` second in `opencode.json` or `opencode.jsonc`.
+Some providers need an auth companion plugin. Add the companion plugin first and `@slkiser/opencode-quota` second.
 
 <a id="cursor-quick-setup"></a>
 
@@ -210,9 +315,9 @@ Add both plugins to `opencode.json`, with the Cursor auth plugin first:
   "plugin": ["@playwo/opencode-cursor-oauth", "@slkiser/opencode-quota"],
   "provider": {
     "cursor": {
-      "name": "Cursor"
-    }
-  }
+      "name": "Cursor",
+    },
+  },
 }
 ```
 
@@ -233,7 +338,7 @@ 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"]
+  "plugin": ["opencode-qwencode-auth", "@slkiser/opencode-quota"],
 }
 ```
 
@@ -248,7 +353,7 @@ Add both plugins to `opencode.json`, with the Antigravity auth plugin first:
 ```jsonc
 {
   "$schema": "https://opencode.ai/config.json",
-  "plugin": ["opencode-antigravity-auth", "@slkiser/opencode-quota"]
+  "plugin": ["opencode-antigravity-auth", "@slkiser/opencode-quota"],
 }
 ```
 
@@ -258,20 +363,12 @@ Add both plugins to `opencode.json`, with the Antigravity auth plugin first:
 
 Companion plugin: [`opencode-gemini-auth`](https://github.com/jenslys/opencode-gemini-auth#readme)
 
-Add both plugins to `opencode.json`, with the Gemini auth plugin first. If you manually choose providers, include `google-gemini-cli` in `opencode-quota/quota-toast.json`:
+Add both plugins to `opencode.json`, with the Gemini auth plugin first:
 
 ```jsonc
-// opencode.json
 {
   "$schema": "https://opencode.ai/config.json",
-  "plugin": ["opencode-gemini-auth", "@slkiser/opencode-quota"]
-}
-```
-
-```jsonc
-// opencode-quota/quota-toast.json
-{
-  "enabledProviders": ["google-gemini-cli"]
+  "plugin": ["opencode-gemini-auth", "@slkiser/opencode-quota"],
 }
 ```
 
@@ -281,6 +378,8 @@ Then authenticate Google once:
 opencode auth login --provider google
 ```
 
+If you use manual provider selection, include `google-gemini-cli` in `enabledProviders`.
+
 ### OpenCode Go
 
 <a id="opencode-go-quick-setup"></a>
@@ -292,9 +391,9 @@ export OPENCODE_GO_WORKSPACE_ID="your-workspace-id"
 export OPENCODE_GO_AUTH_COOKIE="your-auth-cookie"
 ```
 
-The provider can report three usage windows — **5h** rolling, **Weekly**, and **Monthly** — and emits whichever dashboard windows are available in that order. Filter displayed windows with `opencodeGoWindows` in `opencode-quota/quota-toast.json` (`rolling`, `weekly`, `monthly`); non-default subsets report missing selected dashboard fields, while default/all-windows mode shows available windows and diagnostics indicate what was found.
+OpenCode Go can show **5h**, **Weekly**, and **Monthly** windows. Use `opencodeGoWindows` in `opencode-quota/quota-toast.json` to choose a subset.
 
-Environment variables take precedence over the optional `opencode-go.json` config file. Run `/quota_status` to see the exact paths checked on your machine.
+Environment variables take precedence over the optional `opencode-go.json` file. Run `/quota_status` to see the exact paths checked.
 
 ### Troubleshooting
 
@@ -308,18 +407,20 @@ If quota or token data looks wrong:
 
 ### Provider Troubleshooting
 
+For companion providers, confirm the auth plugin appears before `@slkiser/opencode-quota` in `opencode.json`.
+
 <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>
 
@@ -328,14 +429,12 @@ Run `/quota_status` and check the Anthropic section.
 
 Run `/quota_status` and check `copilot_quota_auth`, `billing_mode`, `billing_scope`, and `quota_api`.
 
-For personal Copilot OAuth quota, the plugin uses GitHub's reported premium-interaction quota fields when available. If that specific quota payload marks premium interactions as unlimited, quota output renders `Unlimited` instead of a synthetic used/total ratio.
-
-| 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>
 
@@ -344,10 +443,10 @@ For personal Copilot OAuth quota, the plugin uses GitHub's reported premium-inte
 
 Run `/quota_status` and check the OpenAI auth source and token status.
 
-| Symptom | Fix |
-| --- | --- |
-| OpenAI quota missing | Confirm OpenCode native OpenAI auth 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>
@@ -357,13 +456,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>
 
@@ -372,12 +471,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>
 
@@ -386,28 +485,29 @@ 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, Synthetic, Z.ai, and NanoGPT</strong></summary>
+<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.
+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. |
-| 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. |
+| 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` 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.              |
 
 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.
 
@@ -418,12 +518,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>
 
@@ -432,12 +532,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>
 
@@ -446,13 +546,13 @@ 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>
 
@@ -461,15 +561,19 @@ Run `/quota_status` and check the `opencode_go` section.
 
 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
+
+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
 
 MIT

package/dist/lib/anthropic.d.ts

@@ -53,6 +53,7 @@ export interface AnthropicDiagnostics {
 }
 export interface AnthropicProbeOptions {
     binaryPath?: string;
+    requestTimeoutMs?: number;
 }
 export type ClaudeCommandInvocation = {
     file: string;

package/dist/lib/anthropic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/lib/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqBH,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,oBAAoB,CAAC;IAChC,SAAS,EAAE,oBAAoB,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,SAAS,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,eAAe,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,IAAI,CAAC;AAChF,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAClF,MAAM,MAAM,oBAAoB,GAC5B,yBAAyB,GACzB,8BAA8B,GAC9B,MAAM,CAAC;AAEX,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,mBAAmB,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,oBAAoB,CAAC;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAWD,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAmEF,wBAAgB,0BAA0B,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAGtE;AAgBD,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7D,uBAAuB,CAiBzB;AAsHD,iBAAS,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAiBtE;AAklBD,wBAAgB,sCAAsC,IAAI,IAAI,CAG7D;AAmDD,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CAyF/B;AAED,wBAAsB,iCAAiC,CACrD,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,eAAe,CAAC,CAuB1B;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/lib/anthropic.ts"],"names":[],"mappings":"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"}