oc-auth-switcher 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 grenaad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,109 @@
+# oc-auth-switcher
+
+Multi-account rotation companion plugin for OpenCode. Works alongside `@ex-machina/opencode-anthropic-auth` to automatically rotate between multiple Anthropic Claude Max accounts based on utilization thresholds.
+
+## How It Works
+
+This plugin does **not** replace your auth plugin. Instead it:
+
+1. Maintains a pool of Anthropic OAuth accounts in a separate file
+2. Monitors utilization metrics via CLI `ping` commands
+3. Rotates the active account by writing credentials to `auth.json` via the OpenCode SDK
+4. `@ex-machina/opencode-anthropic-auth` reads the rotated credentials on the next API request
+
+The plugin also hooks into OpenCode's `session.idle` and `chat.message` events to check cached metrics and rotate proactively before thresholds are hit.
+
+## Setup
+
+### 1. Install both plugins
+
+```json
+{
+  "plugin": [
+    "@ex-machina/opencode-anthropic-auth@1.8.0",
+    "oc-auth-switcher@latest"
+  ]
+}
+```
+
+**Important:** `@ex-machina/opencode-anthropic-auth` must be listed first.
+
+### 2. Add accounts
+
+```bash
+# Add your primary account
+oc-auth-switcher add primary
+
+# Add fallback accounts
+oc-auth-switcher add fallback-1
+oc-auth-switcher add fallback-2
+```
+
+Each `add` command runs an OAuth flow — you'll be given a URL to open in your browser and prompted to paste the callback.
+
+### 3. Ping to capture initial metrics
+
+```bash
+oc-auth-switcher ping
+```
+
+### 4. Use OpenCode normally
+
+The plugin handles rotation automatically. The first account in the pool is always the "primary" (preferred). When it exceeds the utilization threshold, traffic switches to the next available fallback. When the primary recovers, it switches back.
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `add [name]` | Add a new account via OAuth |
+| `remove <name>` | Remove an account from the pool |
+| `usage [--watch]` | Show utilization dashboard with progress bars |
+| `config [options]` | View/modify thresholds and check interval |
+| `ping [name]` | Ping account(s) to refresh utilization metrics |
+| `reauth <name>` | Re-authenticate an existing account |
+| `switch <name>` | Manually switch to a specific account |
+| `status` | Show current active account and rotation state |
+
+## Configuration
+
+```bash
+# Set uniform threshold (default: 70%)
+oc-auth-switcher config --threshold 0.80
+
+# Set per-metric thresholds (5h, 7d, 7d-sonnet)
+oc-auth-switcher config --thresholds 90,80,70
+
+# Set primary recovery check interval (default: 60 min)
+oc-auth-switcher config --interval 30
+
+# Reset to defaults
+oc-auth-switcher config --reset
+```
+
+## Data Files
+
+| File | Location | Purpose |
+|------|----------|---------|
+| Accounts | `~/.config/opencode/auth-switcher-accounts.json` | OAuth token pool |
+| State | `~/.config/opencode/auth-switcher-state.json` | Usage metrics, active account, config |
+
+Both files use atomic writes with `.bak` fallback for crash safety.
+
+## Rotation Algorithm
+
+- The first account in the pool is always "primary" (preferred)
+- When the primary exceeds any utilization threshold, switch to the first fallback under threshold
+- If all fallbacks are also over threshold, pick the one with the lowest utilization score
+- When on a fallback, periodically check if the primary has recovered (configurable interval)
+- Auth failures trigger a 1-hour cooldown per account
+
+## Building from Source
+
+```bash
+bun install
+bun run build
+```
+
+## License
+
+MIT