@slkiser/opencode-quota 2.11.1 → 2.12.0

package/README.md

@@ -78,7 +78,7 @@ That is enough for most installs. Providers are auto-detected from your existing
 
 | Provider | Auto setup | How it works |
 | --- | --- | --- |
-| **Anthropic (Claude)** | Needs [quick setup](#anthropic-quick-setup) | Claude Code credentials or env. |
+| **Anthropic (Claude)** | Needs [quick setup](#anthropic-quick-setup) | Local Claude CLI auth/status probe. |
 | **GitHub Copilot** | Usually | OpenCode auth; PAT only for managed billing. |
 | **OpenAI** | Yes | OpenCode auth. |
 | **Cursor** | Needs [quick setup](#cursor-quick-setup) | Companion auth plugin + `provider.cursor`. |
@@ -94,20 +94,18 @@ That is enough for most installs. Providers are auto-detected from your existing
 <details>
 <summary><strong>Quick setup: Anthropic (Claude)</strong></summary>
 
-Anthropic quota support uses Claude Code credentials and surfaces the 5-hour and 7-day rate-limit windows.
+Anthropic quota support now checks the local Claude CLI instead of passing Claude consumer OAuth tokens directly to Anthropic APIs.
 
-Credential resolution order:
-
-1. `~/.claude/.credentials.json` → `claudeAiOauth.accessToken`
-2. `CLAUDE_CODE_OAUTH_TOKEN` environment variable
+If Claude Code is already installed and authenticated, this usually works automatically. Otherwise:
 
-OpenCode `auth.json` is not used for Anthropic quota resolution.
+1. Install Claude Code so `claude` is available on your `PATH`.
+2. Run `claude auth login`.
+3. Confirm `claude auth status` succeeds locally.
+4. Confirm OpenCode is configured with the `anthropic` provider.
 
-If Claude Code is already installed and authenticated, this usually works automatically. Otherwise:
+If Claude lives at a custom path, set `experimental.quotaToast.anthropicBinaryPath`. The default is `claude`.
 
-1. Run Claude Code once so it writes `~/.claude/.credentials.json`.
-2. If needed, set `CLAUDE_CODE_OAUTH_TOKEN` manually as a fallback.
-3. Confirm OpenCode is configured with the `anthropic` provider.
+If you use Anthropic via API key in OpenCode, model usage still works normally. This plugin only shows Anthropic quota rows when the local Claude CLI exposes quota windows.
 
 For behavior details and troubleshooting, see [Anthropic notes](#anthropic-notes).
 
@@ -202,14 +200,18 @@ There is no `/token` command. The reporting commands are the `/tokens_*` family.
 <details>
 <summary><strong>Anthropic (Claude)</strong></summary>
 
-Quota is fetched from `GET https://api.anthropic.com/api/oauth/usage` using a Claude Code OAuth access token.
+The plugin probes the local Claude CLI with `anthropicBinaryPath --version` and `anthropicBinaryPath auth status`. By default `anthropicBinaryPath` is `claude`, so standard installs work without extra config. It does not pass Claude Free/Pro/Max OAuth tokens directly to Anthropic endpoints.
+
+If the Claude CLI exposes 5-hour and 7-day quota windows in local structured output, the plugin shows them. If the CLI only exposes auth state, Anthropic quota rows are skipped and `/quota_status` explains why.
 
 **Troubleshooting:**
 
 | Problem | Solution |
 | --- | --- |
-| "No credentials found" | Run Claude Code once so it writes `~/.claude/.credentials.json`, or set `CLAUDE_CODE_OAUTH_TOKEN` |
-| "Invalid or expired token" | Refresh `~/.claude/.credentials.json` by re-authenticating Claude Code, or update `CLAUDE_CODE_OAUTH_TOKEN` |
+| `claude` not found | Install Claude Code and make sure `claude` is on your `PATH` |
+| Claude installed at a custom path | Set `experimental.quotaToast.anthropicBinaryPath` to the Claude executable path |
+| Not authenticated | Run `claude auth login`, then confirm `claude auth status` works |
+| Authenticated but no quota rows | Your local Claude CLI version did not expose quota windows; run `/quota_status` for the exact probe result |
 | Plugin not detected | Confirm OpenCode is configured with the `anthropic` provider |
 
 </details>
@@ -418,6 +420,7 @@ Workspace-local config can still customize display/report behavior, but user/glo
 | `enableToast` | `true` | Show popup toasts |
 | `toastStyle` | `classic` | Toast layout: `classic` or `grouped` |
 | `enabledProviders` | `"auto"` | Auto-detect providers, or set an explicit provider list |
+| `anthropicBinaryPath` | `"claude"` | Command/path used for local Claude CLI probing; override this for custom installs or shim locations |
 | `minIntervalMs` | `300000` | Minimum fetch interval between provider updates |
 | `toastDurationMs` | `9000` | Toast duration in milliseconds |
 | `showOnIdle` | `true` | Show toast on idle trigger |
@@ -479,7 +482,7 @@ MIT
 
 OpenCode Quota is not built by the OpenCode team and is not affiliated with OpenCode or any provider listed above.
 
-The Anthropic provider uses the documented OAuth usage endpoint with Claude Code credentials from `~/.claude/.credentials.json` or `CLAUDE_CODE_OAUTH_TOKEN`.
+Anthropic quota detection is delegated to the local Claude CLI/runtime. OpenCode Anthropic API-key usage is unaffected, but this plugin only surfaces Anthropic quota rows when the local Claude CLI exposes them.
 
 ## Star History
 

package/dist/lib/anthropic.d.ts

@@ -1,20 +1,23 @@
 /**
- * Anthropic Claude quota fetcher.
+ * Anthropic Claude quota probing.
  *
- * Reads a Claude Code OAuth access token from local Claude credentials and
- * queries the Anthropic usage API to surface 5-hour and 7-day rate-limit
- * windows.
- *
- * Supported credential sources:
- *   1. ~/.claude/.credentials.json → claudeAiOauth.accessToken
- *   2. CLAUDE_CODE_OAUTH_TOKEN environment variable
+ * Uses the local Claude CLI/runtime to detect install/auth state and surface
+ * quota windows only when the official runtime exposes them locally. This
+ * module does not read Claude consumer OAuth tokens or call Anthropic's OAuth
+ * usage endpoint directly.
  */
-declare const CREDENTIALS_PATH: string;
 export interface AnthropicQuotaWindow {
-    /** Used percentage [0..100]. */
-    used_percentage: number;
-    /** ISO timestamp when this window resets. */
-    resets_at: string;
+    utilization?: number;
+    used_percentage?: number;
+    usedPercentage?: number;
+    used_percent?: number;
+    usedPercent?: number;
+    percent_used?: number;
+    percentUsed?: number;
+    resets_at?: string;
+    resetsAt?: string;
+    reset_at?: string;
+    resetAt?: string;
 }
 export interface AnthropicUsageResponse {
     five_hour: AnthropicQuotaWindow;
@@ -36,28 +39,35 @@ export interface AnthropicQuotaError {
     error: string;
 }
 export type AnthropicResult = AnthropicQuotaResult | AnthropicQuotaError | null;
-interface ClaudeCredentials {
-    claudeAiOauth?: {
-        accessToken?: string;
-        expiresAt?: number;
-    };
+export type AnthropicAuthStatus = "authenticated" | "unauthenticated" | "unknown";
+export type AnthropicQuotaSource = "claude-auth-status-json" | "none";
+export interface AnthropicDiagnostics {
+    installed: boolean;
+    version: string | null;
+    authStatus: AnthropicAuthStatus;
+    quotaSupported: boolean;
+    quotaSource: AnthropicQuotaSource;
+    checkedCommands: string[];
+    message?: string;
+    quota?: AnthropicQuotaResult;
 }
-export interface ResolvedAnthropicCredentials {
-    accessToken: string;
-    expiresAt?: number;
-    source: "file" | "env";
+export interface AnthropicProbeOptions {
+    binaryPath?: string;
 }
-declare function readCredentialsFile(): ClaudeCredentials | null;
-export declare function resolveAnthropicCredentialsFromFile(credentials: ClaudeCredentials | null | undefined): ResolvedAnthropicCredentials | null;
-export declare function resolveAnthropicCredentials(): Promise<ResolvedAnthropicCredentials | null>;
-export declare function hasAnthropicCredentialsConfigured(): Promise<boolean>;
+export type ClaudeCommandInvocation = {
+    file: string;
+    args: string[];
+    display: string;
+};
+export declare function resolveAnthropicBinaryPath(binaryPath?: string): string;
+export declare function buildClaudeCommandInvocation(binaryPath: string, args: string[], runtime?: {
+    platform?: NodeJS.Platform;
+    comspec?: string;
+}): ClaudeCommandInvocation;
 declare function parseUsageResponse(data: unknown): AnthropicQuotaResult | null;
-/**
- * Query the Anthropic OAuth usage API for Claude rate-limit windows.
- *
- * Returns null when no credentials are found (provider not configured).
- * Returns an error result when credentials exist but the fetch fails.
- */
-export declare function queryAnthropicQuota(): Promise<AnthropicResult>;
-export { CREDENTIALS_PATH, parseUsageResponse, readCredentialsFile };
+export declare function clearAnthropicDiagnosticsCacheForTests(): void;
+export declare function getAnthropicDiagnostics(options?: AnthropicProbeOptions): Promise<AnthropicDiagnostics>;
+export declare function hasAnthropicCredentialsConfigured(options?: AnthropicProbeOptions): Promise<boolean>;
+export declare function queryAnthropicQuota(options?: AnthropicProbeOptions): Promise<AnthropicResult>;
+export { parseUsageResponse };
 //# sourceMappingURL=anthropic.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/lib/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,QAAA,MAAM,gBAAgB,QAAkD,CAAC;AAMzE,MAAM,WAAW,oBAAoB;IACnC,gCAAgC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB;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;AAEhF,UAAU,iBAAiB;IACzB,aAAa,CAAC,EAAE;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;CACxB;AAUD,iBAAS,mBAAmB,IAAI,iBAAiB,GAAG,IAAI,CAWvD;AAED,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAChD,4BAA4B,GAAG,IAAI,CAgBrC;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAEhG;AAED,wBAAsB,iCAAiC,IAAI,OAAO,CAAC,OAAO,CAAC,CAE1E;AAwBD,iBAAS,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,oBAAoB,GAAG,IAAI,CAyBtE;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,eAAe,CAAC,CAyEpE;AAED,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/lib/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,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,GAAG,yBAAyB,GAAG,MAAM,CAAC;AAEtE,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;AAiBF,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;AAwRD,wBAAgB,sCAAsC,IAAI,IAAI,CAE7D;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CA6C/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,CAY1B;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}