opencode-cliproxyapi-sync 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 itsmylife44
+
+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,166 @@
+# opencode-cliproxyapi-sync
+
+Auto-sync OpenCode configs from CLIProxyAPI Dashboard.
+
+## What it does
+
+This plugin automatically syncs your OpenCode configuration (`opencode.json` and `oh-my-opencode.json`) from the CLIProxyAPI Dashboard. It checks for config updates on OpenCode startup and applies them automatically.
+
+## Features
+
+- 🔄 **Automatic Sync**: Checks for config updates on OpenCode startup
+- ⚡ **Fast**: Only syncs when configs actually change (version-based)
+- 🔒 **Secure**: Uses sync tokens for authentication
+- 📝 **Smart Notifications**: Only shows toast when `opencode.json` changes (requiring restart)
+- 💾 **Atomic Writes**: Safe config file updates (no partial writes)
+
+## Installation
+
+### Option 1: NPX Install (Recommended)
+
+```bash
+npx opencode install opencode-cliproxyapi-sync
+```
+
+### Option 2: Manual Configuration
+
+Add to your `~/.config/opencode/opencode.json` plugins array:
+
+```json
+{
+  "plugin": [
+    "opencode-cliproxyapi-sync",
+    "oh-my-opencode@latest",
+    "..."
+  ]
+}
+```
+
+**Important**: Place `opencode-cliproxyapi-sync` **before** `oh-my-opencode` in the plugins array to ensure config is synced before oh-my-opencode loads.
+
+## Setup
+
+### 1. Generate Sync Token
+
+1. Open the CLIProxyAPI Dashboard
+2. Navigate to **Settings** → **Config Sync**
+3. Click **Generate Sync Token**
+4. Copy the token (it starts with `tok_...`)
+
+### 2. Create Plugin Config File
+
+Create the config file at `~/.config/opencode-cliproxyapi-sync/config.json`:
+
+```json
+{
+  "dashboardUrl": "https://dashboard.yourdomain.com",
+  "syncToken": "tok_abc123...",
+  "lastKnownVersion": null
+}
+```
+
+**Config Fields**:
+- `dashboardUrl`: Your CLIProxyAPI Dashboard URL (no trailing slash)
+- `syncToken`: The sync token from Step 1
+- `lastKnownVersion`: Leave as `null` (plugin manages this automatically)
+
+**Security**: The plugin automatically sets restrictive permissions (chmod 600) on the config file.
+
+## How it works
+
+1. **On OpenCode Startup**: Plugin loads and checks your config
+2. **Version Check**: Fetches current config version from dashboard
+3. **Compare**: If version differs from `lastKnownVersion`, fetches full bundle
+4. **Write Configs**: Atomically writes `opencode.json` and `oh-my-opencode.json`
+5. **Notify**: Shows toast if `opencode.json` changed (requiring restart)
+6. **Update Version**: Saves new version to plugin config
+
+## Configuration Sync Behavior
+
+- **Sync Timing**: Only on OpenCode startup (not while running)
+- **Network Timeout**: 5s for version check, 10s for bundle download
+- **Retries**: Up to 2 retries with exponential backoff (1s, 2s)
+- **Error Handling**: All errors logged but never crash OpenCode
+
+## Notifications
+
+The plugin shows a toast notification **only when** `opencode.json` changes:
+
+> ⚠️ **Config Sync**  
+> opencode.json updated. Restart OpenCode to apply provider changes.
+
+If only `oh-my-opencode.json` changes, no notification is shown (those changes apply immediately on next session).
+
+## File Locations
+
+- **Plugin Config**: `~/.config/opencode-cliproxyapi-sync/config.json`
+- **OpenCode Config**: `~/.config/opencode/opencode.json`
+- **Oh My OpenCode Config**: `~/.config/opencode/oh-my-opencode.json`
+
+(Respects `XDG_CONFIG_HOME` environment variable if set)
+
+## Troubleshooting
+
+### Plugin doesn't sync
+
+**Check config file exists and is valid**:
+```bash
+cat ~/.config/opencode-cliproxyapi-sync/config.json
+```
+
+**Check OpenCode logs** for sync messages:
+```bash
+# Look for lines like:
+[cliproxyapi-sync] Synced to version abc123...
+[cliproxyapi-sync] Failed to check version. Skipping sync.
+```
+
+### Authentication errors (401)
+
+- Verify your `syncToken` is correct
+- Check if token was revoked in Dashboard → Settings → Config Sync
+- Generate a new token if needed
+
+### Config not updating
+
+- Ensure dashboard URL is correct (no trailing slash)
+- Check firewall/network allows access to dashboard
+- Verify dashboard is running and accessible
+
+### Notification not showing
+
+- Notification only appears when `opencode.json` changes
+- If only `oh-my-opencode.json` changed, no notification is shown (expected)
+
+## Development
+
+### Build from source
+
+```bash
+cd plugin
+bun install
+bun build src/index.ts --outdir dist --target node
+```
+
+### Local testing
+
+1. Build the plugin (see above)
+2. Link locally:
+   ```bash
+   cd plugin
+   npm link
+   cd ~/.config/opencode
+   npm link opencode-cliproxyapi-sync
+   ```
+3. Add `"opencode-cliproxyapi-sync"` to your `opencode.json` plugins array
+4. Restart OpenCode
+
+## License
+
+MIT
+
+## Support
+
+- **Dashboard Issues**: https://github.com/itsmylife44/opencode-cliproxyapi-sync/issues
+- **CLIProxyAPI**: https://github.com/router-for-me/CLIProxyAPI
+- **OpenCode**: https://opencode.ai

package/dist/index.js

@@ -0,0 +1,208 @@
+import { createRequire } from "node:module";
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/index.ts
+import { join as join3 } from "path";
+
+// src/config.ts
+import { readFileSync, writeFileSync, existsSync, mkdirSync, chmodSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+function getConfigDir() {
+  const xdgConfigHome = process.env.XDG_CONFIG_HOME;
+  const baseDir = xdgConfigHome || join(homedir(), ".config");
+  return join(baseDir, "opencode-cliproxyapi-sync");
+}
+function getConfigPath() {
+  return join(getConfigDir(), "config.json");
+}
+function loadPluginConfig() {
+  try {
+    const configPath = getConfigPath();
+    if (!existsSync(configPath)) {
+      return null;
+    }
+    const content = readFileSync(configPath, "utf-8");
+    const config = JSON.parse(content);
+    if (!config.dashboardUrl || !config.syncToken) {
+      console.error("[cliproxyapi-sync] Invalid config: missing dashboardUrl or syncToken");
+      return null;
+    }
+    return config;
+  } catch (error) {
+    console.error("[cliproxyapi-sync] Failed to load config:", error);
+    return null;
+  }
+}
+function savePluginConfig(config) {
+  try {
+    const configDir = getConfigDir();
+    const configPath = getConfigPath();
+    if (!existsSync(configDir)) {
+      mkdirSync(configDir, { recursive: true });
+    }
+    const tempPath = `${configPath}.tmp`;
+    writeFileSync(tempPath, JSON.stringify(config, null, 2), "utf-8");
+    chmodSync(tempPath, 384);
+    writeFileSync(configPath, readFileSync(tempPath));
+    chmodSync(configPath, 384);
+    try {
+      const { unlinkSync } = __require("fs");
+      unlinkSync(tempPath);
+    } catch {}
+  } catch (error) {
+    console.error("[cliproxyapi-sync] Failed to save config:", error);
+    throw error;
+  }
+}
+
+// src/sync.ts
+async function fetchWithTimeout(url, options, timeoutMs) {
+  const controller = new AbortController;
+  const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const response = await fetch(url, {
+      ...options,
+      signal: controller.signal
+    });
+    return response;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+async function retryFetch(fetcher, maxRetries = 2) {
+  const delays = [1000, 2000];
+  for (let attempt = 0;attempt <= maxRetries; attempt++) {
+    try {
+      return await fetcher();
+    } catch (error) {
+      if (attempt === maxRetries) {
+        return null;
+      }
+      const delay = delays[attempt] || 2000;
+      await new Promise((resolve) => setTimeout(resolve, delay));
+    }
+  }
+  return null;
+}
+async function checkVersion(dashboardUrl, token) {
+  return retryFetch(async () => {
+    const url = `${dashboardUrl}/api/config-sync/version`;
+    const response = await fetchWithTimeout(url, {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${token}`
+      }
+    }, 5000);
+    if (!response.ok) {
+      if (response.status === 401) {
+        console.error("[cliproxyapi-sync] Invalid or revoked sync token (401)");
+      }
+      throw new Error(`HTTP ${response.status}`);
+    }
+    return await response.json();
+  });
+}
+async function fetchBundle(dashboardUrl, token) {
+  return retryFetch(async () => {
+    const url = `${dashboardUrl}/api/config-sync/bundle`;
+    const response = await fetchWithTimeout(url, {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${token}`
+      }
+    }, 1e4);
+    if (!response.ok) {
+      if (response.status === 401) {
+        console.error("[cliproxyapi-sync] Invalid or revoked sync token (401)");
+      }
+      throw new Error(`HTTP ${response.status}`);
+    }
+    return await response.json();
+  });
+}
+
+// src/writer.ts
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync2, renameSync } from "fs";
+import { createHash } from "crypto";
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
+function getOpenCodeConfigDir() {
+  const xdgConfigHome = process.env.XDG_CONFIG_HOME;
+  if (xdgConfigHome) {
+    return join2(xdgConfigHome, "opencode");
+  }
+  return join2(homedir2(), ".config", "opencode");
+}
+async function writeConfigAtomic(filePath, content) {
+  const tempPath = `${filePath}.cliproxy-sync.tmp`;
+  writeFileSync2(tempPath, content, "utf-8");
+  renameSync(tempPath, filePath);
+}
+async function readFileHash(filePath) {
+  try {
+    if (!existsSync2(filePath)) {
+      return null;
+    }
+    const content = readFileSync2(filePath, "utf-8");
+    const hash = createHash("sha256");
+    hash.update(content);
+    return hash.digest("hex");
+  } catch (error) {
+    console.error(`[cliproxyapi-sync] Failed to hash ${filePath}:`, error);
+    return null;
+  }
+}
+
+// src/index.ts
+var ConfigSyncPlugin = async (ctx) => {
+  try {
+    const config = loadPluginConfig();
+    if (!config || !config.syncToken || !config.dashboardUrl) {
+      console.log("[cliproxyapi-sync] No config found. Skipping sync.");
+      return {};
+    }
+    const versionResult = await checkVersion(config.dashboardUrl, config.syncToken);
+    if (!versionResult) {
+      console.error("[cliproxyapi-sync] Failed to check version. Skipping sync.");
+      return {};
+    }
+    if (versionResult.version === config.lastKnownVersion) {
+      return {};
+    }
+    const bundle = await fetchBundle(config.dashboardUrl, config.syncToken);
+    if (!bundle) {
+      console.error("[cliproxyapi-sync] Failed to fetch bundle. Skipping sync.");
+      return {};
+    }
+    const configDir = getOpenCodeConfigDir();
+    const opencodeConfigPath = join3(configDir, "opencode.json");
+    const ohMyConfigPath = join3(configDir, "oh-my-opencode.json");
+    const oldOpencodeHash = await readFileHash(opencodeConfigPath);
+    await writeConfigAtomic(opencodeConfigPath, JSON.stringify(bundle.opencode, null, 2));
+    if (bundle.ohMyOpencode) {
+      await writeConfigAtomic(ohMyConfigPath, JSON.stringify(bundle.ohMyOpencode, null, 2));
+    }
+    const newOpencodeHash = await readFileHash(opencodeConfigPath);
+    if (oldOpencodeHash !== null && oldOpencodeHash !== newOpencodeHash) {
+      ctx.client.tui.showToast({
+        body: {
+          title: "Config Sync",
+          message: "opencode.json updated. Restart OpenCode to apply provider changes.",
+          variant: "warning",
+          duration: 8000
+        }
+      });
+    }
+    config.lastKnownVersion = bundle.version;
+    savePluginConfig(config);
+    console.log(`[cliproxyapi-sync] Synced to version ${bundle.version}`);
+  } catch (error) {
+    console.error("[cliproxyapi-sync] Sync error:", error);
+  }
+  return {};
+};
+var src_default = ConfigSyncPlugin;
+export {
+  src_default as default
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "opencode-cliproxyapi-sync",
+  "version": "1.0.0",
+  "description": "Auto-sync OpenCode configs from CLIProxyAPI Dashboard",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target node"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": "*"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "latest",
+    "typescript": "^5.0.0",
+    "@types/node": "^22.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "opencode",
+    "plugin",
+    "config-sync",
+    "cliproxyapi"
+  ],
+  "license": "MIT",
+  "author": "itsmylife44",
+  "homepage": "https://github.com/itsmylife44/opencode-cliproxyapi-sync#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/itsmylife44/opencode-cliproxyapi-sync.git"
+  },
+  "bugs": {
+    "url": "https://github.com/itsmylife44/opencode-cliproxyapi-sync/issues"
+  }
+}