@xtruder/opencode-claude-max-plugin 0.1.17 → 0.2.2

package/README.md

@@ -2,6 +2,8 @@
 
 An [OpenCode](https://opencode.ai/) plugin that enables Claude Pro/Max subscription access via the official [`@anthropic-ai/sdk`](https://github.com/anthropics/anthropic-sdk-typescript), using OAuth credentials from Claude Code (`~/.claude/.credentials.json`).
 
+![Usage sidebar and /usage command dialog](assets/example-with-usage.png)
+
 ## Why?
 
 - **Use your Claude subscription** — Automatically reads OAuth credentials from Claude Code, no separate API key needed
@@ -9,7 +11,7 @@ An [OpenCode](https://opencode.ai/) plugin that enables Claude Pro/Max subscript
 - **Prompt caching** — 98% of input tokens served from cache (system prompt + tools cached globally)
 - **All Claude models** — Opus 4.6, Sonnet 4.6, Haiku 4.5
 - **Extended thinking** — Full reasoning support with thinking variants (high/max)
-- **Usage tracking** — Built-in `/usage` command shows subscription utilization
+- **Usage tracking** — Sidebar widget with live progress bars + `/usage` command with full details
 - **Self-registering** — Models are registered automatically, no manual provider config needed
 
 ## Installation
@@ -27,6 +29,57 @@ That's it. The plugin self-registers the `anthropic-sdk` provider and its models
 
 Then open OpenCode and run `/connect` → Other → `anthropic-sdk`. If Claude Code is installed and you're logged in, credentials are read automatically from `~/.claude/.credentials.json` — no API key needed.
 
+### TUI Plugin (sidebar + /usage command)
+
+The plugin includes a TUI component that shows subscription usage in the sidebar and registers a `/usage` slash command. To enable it, add the plugin to your `tui.json` as well:
+
+**Project-level** (`.opencode/tui.json`):
+
+```json
+{
+  "plugin": ["@xtruder/opencode-claude-max-plugin"]
+}
+```
+
+**Or globally** (`~/.config/opencode/tui.json`):
+
+```json
+{
+  "plugin": ["@xtruder/opencode-claude-max-plugin"]
+}
+```
+
+The TUI plugin provides:
+
+- **Sidebar widget** — Compact progress bars for 5-hour session and 7-day weekly usage
+- **`/usage` command** — Opens a dialog with full usage breakdown (per-model, extra usage)
+- **Auto-refresh** — Polls the usage API every 60s and after each inference call
+
+#### TUI Configuration
+
+Options can be set in the `tui.json` plugin entry:
+
+```json
+{
+  "plugin": [
+    [
+      "@xtruder/opencode-claude-max-plugin",
+      {
+        "enabled": true,
+        "sidebar": true,
+        "poll_interval": 60
+      }
+    ]
+  ]
+}
+```
+
+| Option          | Type    | Default | Description                               |
+| --------------- | ------- | ------- | ----------------------------------------- |
+| `enabled`       | boolean | `true`  | Enable/disable the TUI plugin entirely    |
+| `sidebar`       | boolean | `true`  | Show/hide sidebar usage widget            |
+| `poll_interval` | number  | `60`    | Seconds between usage API polls (min: 10) |
+
 ### Custom model options
 
 If you want to override model settings (e.g. thinking budgets, variants), you can add a `provider` block alongside the plugin:
@@ -71,25 +124,10 @@ For Claude Code credentials, log in via `claude` CLI first (`claude auth login`)
 - MCP tool name remapping (`server_tool` → `mcp__server__tool`)
 - Extended thinking with signature passthrough for multi-turn conversations
 - Prompt caching (98% cache hit rate with full OpenCode tool set)
+- CCH request signing — computes xxHash64 body integrity hash to unlock features like fast mode
 - Subscription rate limit detection — fails fast with clear message instead of hanging
 - Long context auto-detection — adds `context-1m` beta header when request body is large
-- `/usage` slash command — shows current session and weekly utilization
-
-## Usage Command
-
-After adding the config, run `/usage` inside OpenCode to see your subscription usage:
-
-```
-  Claude Subscription Usage
-  ────────────────────────────────────────────────────
-  Current session
-  ████████████████████████████████░░░░░░░░░░░░░░░░░░  67% used
-  Resets 7:00 PM GMT+1
-
-  Current week (all models)
-  ████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  8% used
-  Resets Mar 30, 7:00 AM GMT+2
-```
+- TUI sidebar with live usage bars + `/usage` slash command with full subscription details
 
 ## With Vercel AI SDK
 

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAgGjD,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEhC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IAE/B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAAA;CAChD;AA4BD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CAkItB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAoBhC,CAAA;AAID,eAAe,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAiGjD,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEhC;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IAE/B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAAA;CAChD;AA4BD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CAkItB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAoBhC,CAAA;AAID,eAAe,kBAAkB,CAAA"}