opencode-claude-auth 0.5.3 → 0.5.5

package/README.md

@@ -1,12 +1,14 @@
 # opencode-claude-auth
 
 [![npm](https://img.shields.io/npm/v/opencode-claude-auth)](https://www.npmjs.com/package/opencode-claude-auth)
+[![CI](https://github.com/griffinmartin/opencode-claude-auth/actions/workflows/ci.yml/badge.svg)](https://github.com/griffinmartin/opencode-claude-auth/actions/workflows/ci.yml)
+[![Socket Badge](https://socket.dev/api/badge/npm/package/opencode-claude-auth)](https://socket.dev/npm/package/opencode-claude-auth)
 
 OpenCode plugin that uses your existing Claude Code credentials — no separate login needed.
 
 ## How it works
 
-Claude Code stores OAuth tokens in the macOS Keychain (or `~/.claude/.credentials.json` on other platforms). This plugin reads those tokens and provides them to OpenCode via its auth hook, so you don't need to log in twice. When a token is about to expire, it re-reads credentials automatically. If they're still stale, it runs the Claude CLI to trigger a refresh. For OpenCode > 1.2.27, it also injects the Anthropic session prompt via the `experimental.chat.system.transform` hook.
+Claude Code stores OAuth tokens in the macOS Keychain (or `~/.claude/.credentials.json` on other platforms). This plugin reads those tokens and writes them to OpenCode's `~/.local/share/opencode/auth.json`, so you don't need to log in twice. It re-syncs every 5 minutes to pick up token refreshes. If a token is near expiry, it runs the Claude CLI to trigger a refresh.
 
 ## Prerequisites
 
@@ -28,7 +30,7 @@ Fetch https://raw.githubusercontent.com/griffinmartin/opencode-claude-auth/main/
 ### Manual install
 
 ```bash
-npm install opencode-claude-auth
+npm install -g opencode-claude-auth
 ```
 
 Then add to the `plugin` array in your `opencode.json`:
@@ -41,7 +43,7 @@ Then add to the `plugin` array in your `opencode.json`:
 
 ## Usage
 
-Just run OpenCode. The plugin reads your Claude Code credentials automatically and handles token refresh in the background.
+Just run OpenCode. The plugin syncs your Claude Code credentials to OpenCode's auth.json and refreshes them in the background.
 
 ## Credential sources
 
@@ -63,12 +65,12 @@ The plugin checks these in order:
 
 ## How it works (technical)
 
-- Registers an OpenCode auth hook for the `anthropic` provider
-- Overrides the built-in `opencode-anthropic-auth` plugin
-- Returns a custom `fetch` wrapper that injects `Authorization: Bearer` headers
-- When a token is within 60 seconds of expiry, re-reads credentials from Keychain or file
-- If still expired, runs `claude -p . --model claude-haiku-4-5-20250514` to trigger a refresh
-- For OpenCode > 1.2.27, injects the Anthropic session prompt via `experimental.chat.system.transform`
+- Reads OAuth tokens from macOS Keychain (`Claude Code-credentials` entry) or `~/.claude/.credentials.json` fallback
+- Writes an `anthropic` entry to `~/.local/share/opencode/auth.json` in OpenCode's native OAuth format
+- Preserves other provider entries already in auth.json
+- Re-syncs credentials every 5 minutes in the background
+- When a token is within 60 seconds of expiry, runs `claude` CLI to trigger a refresh
+- If credentials are unavailable or unreadable, the plugin disables itself and OpenCode continues without Claude auth
 
 ## License
 

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAY,MAAM,qBAAqB,CAAA;AAqF3D,QAAA,MAAM,MAAM,EAAE,MAuDb,CAAA;AAED,eAAe,MAAM,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAsEjD,QAAA,MAAM,MAAM,EAAE,MAmCb,CAAA;AAED,eAAe,MAAM,CAAA"}

package/dist/index.js

@@ -1,28 +1,40 @@
 import { execSync } from "node:child_process";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { homedir } from "node:os";
 import { readClaudeCredentials } from "./keychain.js";
-function clearOpencodeAuth() {
-    const authPaths = [
-        join(homedir(), ".local", "share", "opencode", "auth.json"),
-        join(process.env.APPDATA ?? homedir(), "opencode", "auth.json"),
-        join(homedir(), ".opencode", "auth.json"),
-    ];
-    for (const path of authPaths) {
-        try {
-            if (existsSync(path)) {
-                const raw = readFileSync(path, "utf-8");
-                const auth = JSON.parse(raw);
-                delete auth.anthropic;
-                writeFileSync(path, JSON.stringify(auth), "utf-8");
+function getAuthJsonPath() {
+    if (process.platform === "win32") {
+        const appData = process.env.LOCALAPPDATA ?? join(homedir(), "AppData", "Local");
+        return join(appData, "opencode", "auth.json");
+    }
+    return join(homedir(), ".local", "share", "opencode", "auth.json");
+}
+function syncAuthJson(creds) {
+    const authPath = getAuthJsonPath();
+    let auth = {};
+    if (existsSync(authPath)) {
+        const raw = readFileSync(authPath, "utf-8").trim();
+        if (raw) {
+            try {
+                auth = JSON.parse(raw);
+            }
+            catch {
+                // Malformed file, start fresh
             }
-        }
-        catch {
-            // Non-fatal: may not have write permissions
         }
     }
+    auth.anthropic = {
+        type: "oauth",
+        access: creds.accessToken,
+        refresh: creds.refreshToken,
+        expires: creds.expiresAt,
+    };
+    const dir = dirname(authPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(authPath, JSON.stringify(auth, null, 2), "utf-8");
 }
 function refreshViaCli() {
     try {
@@ -37,92 +49,49 @@ function refreshViaCli() {
         // Non-fatal: Claude CLI may not be available
     }
 }
-function loadSessionPrompt() {
-    try {
-        const dir = dirname(fileURLToPath(import.meta.url));
-        const promptPath = join(dir, "anthropic-prompt.txt");
-        return readFileSync(promptPath, "utf-8");
+function refreshIfNeeded() {
+    let creds = readClaudeCredentials();
+    if (creds && creds.expiresAt > Date.now() + 60_000) {
+        return creds;
     }
-    catch {
-        return "You are Claude Code, Anthropic's official CLI for Claude.";
+    // Token is expired or near expiry, try CLI refresh
+    refreshViaCli();
+    creds = readClaudeCredentials();
+    if (creds && creds.expiresAt > Date.now() + 60_000) {
+        return creds;
     }
+    return null;
 }
-function createAuthFetch(initial, onRefresh) {
-    let current = initial;
-    return async (fetchInput, init) => {
-        if (current.expiresAt < Date.now() + 60_000) {
-            const fresh = readClaudeCredentials();
-            if (fresh && fresh.expiresAt > Date.now() + 60_000) {
-                current = fresh;
-                onRefresh(current);
-            }
-            else {
-                refreshViaCli();
-                const afterRefresh = readClaudeCredentials();
-                if (afterRefresh && afterRefresh.expiresAt > Date.now() + 60_000) {
-                    current = afterRefresh;
-                    onRefresh(current);
-                }
-                else {
-                    throw new Error("opencode-claude-auth: Token expired and refresh failed. " +
-                        "Re-authenticate with Claude Code by running `claude` in your terminal.");
-                }
-            }
-        }
-        const headers = new Headers(init?.headers);
-        headers.set("Authorization", `Bearer ${current.accessToken}`);
-        return fetch(fetchInput, { ...init, headers });
-    };
-}
-const plugin = async (input) => {
-    const creds = readClaudeCredentials();
+const SYNC_INTERVAL = 5 * 60 * 1000; // 5 minutes
+const plugin = async () => {
+    let creds = null;
+    try {
+        creds = readClaudeCredentials();
+    }
+    catch (err) {
+        console.warn("opencode-claude-auth: Failed to read Claude Code credentials:", err instanceof Error ? err.message : err);
+        return {};
+    }
     if (!creds) {
+        console.warn("opencode-claude-auth: No Claude Code credentials found. " +
+            "Plugin disabled. Run `claude` to authenticate.");
         return {};
     }
-    const auth = {
-        provider: "anthropic",
-        loader: async (_getAuth, _provider) => {
-            clearOpencodeAuth();
-            const initialCreds = readClaudeCredentials();
-            if (!initialCreds) {
-                throw new Error("opencode-claude-auth: Claude Code credentials not found. " +
-                    "Please authenticate with Claude Code first by running `claude` in your terminal.");
+    // Sync credentials to auth.json on startup
+    syncAuthJson(creds);
+    // Keep auth.json synced, refreshing via CLI if token is near expiry
+    setInterval(() => {
+        try {
+            const fresh = refreshIfNeeded();
+            if (fresh) {
+                syncAuthJson(fresh);
             }
-            await input.client.auth.set({
-                path: { id: "anthropic" },
-                body: {
-                    type: "oauth",
-                    access: initialCreds.accessToken,
-                    refresh: initialCreds.refreshToken,
-                    expires: initialCreds.expiresAt,
-                },
-            });
-            return {
-                apiKey: "oauth",
-                fetch: createAuthFetch(initialCreds, (updated) => {
-                    void input.client.auth.set({
-                        path: { id: "anthropic" },
-                        body: {
-                            type: "oauth",
-                            access: updated.accessToken,
-                            refresh: updated.refreshToken,
-                            expires: updated.expiresAt,
-                        },
-                    });
-                }),
-            };
-        },
-        methods: [],
-    };
-    return {
-        auth,
-        async "experimental.chat.system.transform"(hookInput, output) {
-            if (hookInput.model.providerID !== "anthropic")
-                return;
-            const prompt = loadSessionPrompt();
-            output.system.unshift(prompt);
-        },
-    };
+        }
+        catch {
+            // Non-fatal
+        }
+    }, SYNC_INTERVAL);
+    return {};
 };
 export default plugin;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/installation.md

@@ -45,7 +45,7 @@ This will prompt you to log in and store credentials in Keychain (macOS) or `~/.
 ### Step 1: Install the package
 
 ```bash
-npm install opencode-claude-auth
+npm install -g opencode-claude-auth
 ```
 
 ### Step 2: Add to OpenCode configuration

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "opencode-claude-auth",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "OpenCode plugin that uses your Claude Code credentials — no separate login needed.",
+  "preferGlobal": true,
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",