openclaw-opencode-bridge 2.0.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bettep (hongdaesik88@gmail.com)
+
+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,103 @@
+# openclaw-opencode-bridge
+
+[![npm version](https://img.shields.io/npm/v/openclaw-opencode-bridge)](https://www.npmjs.com/package/openclaw-opencode-bridge)
+[![license](https://img.shields.io/npm/l/openclaw-opencode-bridge)](LICENSE)
+[![node](https://img.shields.io/node/v/openclaw-opencode-bridge)](package.json)
+
+> Forked from [openclaw-claude-bridge](https://github.com/bettep-dev/openclaw-claude-bridge) by [@bettep-dev](https://github.com/bettep-dev) — modified to work with OpenCode instead of Claude CLI.
+
+Bridge [OpenClaw](https://openclaw.ai) messaging channels to [OpenCode](https://opencode.ai) via persistent tmux sessions.
+
+Send `@cc` or `/cc` from any chat — your message is routed directly to OpenCode running in your terminal, bypassing the gateway LLM entirely. No separate API keys, no OAuth, no extra costs.
+
+<p>
+  <img src="DEMO_1.png" alt="Telegram demo — sending a command" width="400" />
+  <img src="DEMO_2.png" alt="Telegram demo — receiving a response" width="400" />
+</p>
+
+> **⚠️ Telegram only.** This plugin has been developed and tested exclusively with the Telegram channel. Other channels (Discord, Slack, etc.) may use different message formats or metadata wrapping that could break prefix detection or LLM suppression. Community contributions for additional channels are welcome — please open an issue if you encounter problems.
+
+## How It Works
+
+<img alt="Architecture" src="https://mermaid.ink/img/Z3JhcGggVEQKICAgIEFbIkNoYXQiXSAtLT58IkBjYyBtZXNzYWdlInwgQlsiT3BlbkNsYXcgR2F0ZXdheSJdCiAgICBCIC0tPiBDWyJvcGVuY29kZS1icmlkZ2UgcGx1Z2luIl0KICAgIEMgLS0+fHN1cHByZXNzIExMTHwgQgogICAgQyAtLT58ZXhlY0ZpbGV8IERbIlNoZWxsIFNjcmlwdCJdCiAgICBEIC0tPnx0bXV4IHBhc3RlLWJ1ZmZlcnwgRVsiT3BlbkNvZGUgLyB0bXV4Il0KICAgIEUgLS0+fCJvcGVuY2xhdyBtZXNzYWdlIHNlbmQifCBB" />
+
+1. User sends a prefixed message (e.g. `@cc deploy the app`)
+2. The plugin intercepts the message and suppresses the gateway LLM
+3. A shell script forwards the message to OpenCode in a persistent tmux session
+4. OpenCode replies back through the same channel via `openclaw message send`
+
+## Prerequisites
+
+| Dependency | Install |
+|---|---|
+| [OpenClaw](https://openclaw.ai) | `npm i -g openclaw` |
+| [OpenCode](https://opencode.ai) | `npm i -g opencode-ai` |
+| [tmux](https://github.com/tmux/tmux) | Auto-installed during onboard if missing |
+
+> **Note:** macOS and Linux only. Windows is not supported (tmux dependency).
+
+## Quick Start
+
+```bash
+npm i -g openclaw-opencode-bridge
+openclaw-opencode-bridge onboard
+```
+
+The interactive wizard configures everything — plugin, shell scripts, OPENCODE.md, daemon, and channel settings.
+
+Verify the connection:
+
+```
+@cc hello
+```
+
+## Commands
+
+| Prefix | Description |
+|---|---|
+| `@cc` · `/cc` | Send to the current session (retains conversation context) |
+| `@ccn` · `/ccn` | Start a fresh session (kills existing, creates new) |
+| `@ccu` · `/ccu` | Show OpenCode usage stats |
+| `@ccm` · `/ccm` | List OpenCode models |
+| `@ccms` · `/ccms` | Set OpenCode model (by number or model-id) |
+
+Messages are sent as-is — no quoting needed:
+
+```
+@cc refactor the auth module and add tests
+@ccn review this PR: https://github.com/org/repo/pull/42
+@ccu
+```
+
+Multiline messages and special characters (`$`, `` ` ``, `\`, quotes) are preserved exactly as typed.
+
+## Migration from v1
+
+v2 replaces the legacy skill/hook system with a single OpenClaw plugin:
+
+```bash
+npm i -g openclaw-opencode-bridge
+openclaw-opencode-bridge onboard
+```
+
+The wizard detects and removes legacy components automatically.
+
+## Uninstall
+
+```bash
+openclaw-opencode-bridge uninstall
+```
+
+Removes all installed components — plugin, shell scripts, OPENCODE.md additions, and daemon.
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---|---|
+| LLM responds instead of delivery message | `openclaw gateway restart` |
+| Delivery confirmed but no reply | Check `tmux ls` — session may have crashed |
+| Multiline sends only first line | Re-run `openclaw-opencode-bridge onboard` (v2.0.6+) |
+
+## License
+
+[MIT](LICENSE)

package/lib/cli.js

@@ -0,0 +1,343 @@
+#!/usr/bin/env node
+"use strict";
+
+const { Command } = require("commander");
+const util = require("util");
+const { exec } = require("child_process");
+const chalk = require("chalk");
+const fs = require("fs");
+const path = require("path");
+const pkg = require("../package.json");
+
+const execAsync = util.promisify(exec);
+
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function startSpinner(text) {
+  let i = 0;
+  const id = setInterval(() => {
+    process.stdout.write(
+      `\r\x1b[K    ${chalk.cyan(SPINNER_FRAMES[i % SPINNER_FRAMES.length])} ${text}`,
+    );
+    i++;
+  }, 80);
+  return {
+    stop(result) {
+      clearInterval(id);
+      process.stdout.write(`\r\x1b[K    ${chalk.green("\u2713")} ${result}\n`);
+    },
+    fail(result) {
+      clearInterval(id);
+      process.stdout.write(`\r\x1b[K    ${chalk.red("\u2717")} ${result}\n`);
+    },
+  };
+}
+
+const program = new Command();
+
+program
+  .name("openclaw-opencode-bridge")
+  .description(
+    "Bridge OpenClaw messaging channels to OpenCode via tmux persistent sessions",
+  )
+  .version(pkg.version);
+
+// --- onboard ---
+program
+  .command("onboard")
+  .description(
+    "Set up the bridge (auto-detects most settings, just press Enter)",
+  )
+  .action(async () => {
+    try {
+      const { onboard } = require("./onboard");
+      await onboard();
+    } catch (e) {
+      console.error(chalk.red(`\n  Setup failed: ${e.message}`));
+      process.exit(1);
+    }
+  });
+
+// --- check ---
+program
+  .command("check")
+  .description("Check if all dependencies are installed")
+  .action(() => {
+    const { checkAll, printStatus } = require("./deps");
+    const { detectOS, getWorkspace } = require("./platform");
+
+    console.log();
+    console.log(`  ${chalk.bold("openclaw-opencode-bridge")} dependency check`);
+    console.log(`  ${"─".repeat(35)}`);
+    console.log();
+
+    console.log(`  ${chalk.bold("Dependencies:")}`);
+    const { results, allFound } = checkAll();
+    printStatus(results);
+    console.log();
+
+    console.log(`  ${chalk.bold("Environment:")}`);
+    console.log(`    OS:        ${detectOS()} (${process.platform})`);
+    console.log(`    Workspace: ${getWorkspace()}`);
+    console.log();
+
+    if (allFound) {
+      console.log(`  ${chalk.green("\u2705")} All dependencies found.`);
+    } else {
+      console.log(
+        `  ${chalk.red("\u274c")} Missing dependencies. See above for install commands.`,
+      );
+    }
+    console.log();
+
+    process.exit(allFound ? 0 : 1);
+  });
+
+// --- uninstall ---
+program
+  .command("uninstall")
+  .description(
+    "Remove daemon, scripts, plugin, legacy hooks, skills, and AGENTS.md",
+  )
+  .action(async () => {
+    const {
+      removeDaemon,
+      getScriptsDir,
+      getWorkspace,
+      getHomeDir,
+    } = require("./platform");
+    const { BRIDGE_COMMANDS, SCRIPT_VARS } = require("./onboard");
+
+    console.log();
+    console.log(
+      `  ${chalk.bold.red("openclaw-opencode-bridge")} ${chalk.dim("uninstall")}`,
+    );
+    console.log(`  ${"─".repeat(40)}`);
+    console.log();
+    await sleep(300);
+
+    // Daemon
+    const sp1 = startSpinner("Stopping daemon...");
+    await sleep(400);
+    const daemonRemoved = removeDaemon();
+    sp1.stop(
+      daemonRemoved
+        ? "Daemon stopped and removed"
+        : chalk.dim("No daemon found"),
+    );
+
+    await sleep(200);
+
+    // Scripts
+    const sp2 = startSpinner("Removing scripts...");
+    await sleep(400);
+    const scriptsDir = getScriptsDir();
+    const scriptFiles = Object.keys(SCRIPT_VARS);
+    let scriptsRemoved = 0;
+    for (const file of scriptFiles) {
+      const fp = path.join(scriptsDir, file);
+      if (fs.existsSync(fp)) {
+        fs.unlinkSync(fp);
+        scriptsRemoved++;
+      }
+    }
+    sp2.stop(
+      scriptsRemoved > 0
+        ? `Scripts removed from ${scriptsDir}`
+        : chalk.dim("No scripts found"),
+    );
+
+    await sleep(200);
+
+    // Plugin
+    const sp3 = startSpinner("Removing plugin...");
+    await sleep(400);
+    const homeDir = getHomeDir();
+    const pluginDir = path.join(
+      homeDir,
+      ".openclaw",
+      "plugins",
+      "opencode-bridge",
+    );
+    const legacyPluginDir = path.join(
+      homeDir,
+      ".openclaw",
+      "plugins",
+      "claude-bridge",
+    );
+    let pluginRemoved = false;
+    
+    for (const dir of [pluginDir, legacyPluginDir]) {
+      if (fs.existsSync(dir)) {
+        fs.rmSync(dir, { recursive: true, force: true });
+        pluginRemoved = true;
+      }
+    }
+    
+    sp3.stop(
+      pluginRemoved
+        ? "Plugin removed (opencode/claude-bridge)"
+        : chalk.dim("No plugin found"),
+    );
+
+    await sleep(200);
+
+    // Legacy hook
+    const workspace = getWorkspace();
+    for (const hook of ["opencode-bridge", "claude-bridge"]) {
+      const hookDir = path.join(workspace, "hooks", hook);
+      if (fs.existsSync(hookDir)) {
+        fs.rmSync(hookDir, { recursive: true, force: true });
+      }
+    }
+
+    // Legacy Skills
+    const skillsDir = path.join(workspace, "skills");
+    const skillNames = BRIDGE_COMMANDS.map((c) => c.command);
+    let skillsToRemove = [];
+    for (const skill of skillNames) {
+      const skillFile = path.join(skillsDir, skill, "SKILL.md");
+      if (fs.existsSync(skillFile)) {
+        skillsToRemove.push(skill);
+      }
+    }
+
+    if (skillsToRemove.length > 0) {
+      const sp4 = startSpinner("Cleaning legacy skills...");
+      await sleep(400);
+      let skillsRemoved = 0;
+      for (const skill of skillsToRemove) {
+        const skillFile = path.join(skillsDir, skill, "SKILL.md");
+        const skillDir = path.join(skillsDir, skill);
+        fs.unlinkSync(skillFile);
+        try {
+          fs.rmdirSync(skillDir);
+        } catch {}
+        skillsRemoved++;
+      }
+      sp4.stop(`Legacy skills removed (${skillsToRemove.join(", ")})`);
+      await sleep(200);
+    }
+
+    // Global AGENTS.md for OpenCode
+    const sp5 = startSpinner("Removing AGENTS.md...");
+    await sleep(400);
+    const opencodeAgentsPath = path.join(homeDir, ".config", "opencode", "AGENTS.md");
+    const opencodeAgentsExisted = fs.existsSync(opencodeAgentsPath);
+    if (opencodeAgentsExisted) {
+      fs.unlinkSync(opencodeAgentsPath);
+    }
+    sp5.stop(
+      opencodeAgentsExisted ? "AGENTS.md removed" : chalk.dim("No AGENTS.md found"),
+    );
+
+    await sleep(200);
+
+    // openclaw.json cleanup
+    const sp6 = startSpinner("Cleaning openclaw.json...");
+    await sleep(400);
+    const openclawConfigPath = path.join(homeDir, ".openclaw", "openclaw.json");
+    let configCleaned = false;
+    let commandsCleaned = false;
+
+    if (fs.existsSync(openclawConfigPath)) {
+      try {
+        const config = JSON.parse(fs.readFileSync(openclawConfigPath, "utf8"));
+        let configChanged = false;
+
+        for (const pluginId of ["opencode-bridge", "claude-bridge"]) {
+          if (config.plugins?.entries?.[pluginId]) {
+            delete config.plugins.entries[pluginId];
+            configChanged = true;
+          }
+          if (config.plugins?.installs?.[pluginId]) {
+            delete config.plugins.installs[pluginId];
+            configChanged = true;
+          }
+          if (Array.isArray(config.plugins?.allow)) {
+            const before = config.plugins.allow.length;
+            config.plugins.allow = config.plugins.allow.filter(
+              (id) => id !== pluginId,
+            );
+            if (config.plugins.allow.length < before) configChanged = true;
+          }
+          if (config.plugins?.[pluginId]) {
+            delete config.plugins[pluginId];
+            configChanged = true;
+          }
+        }
+        
+        if (Array.isArray(config.plugins?.load?.paths)) {
+          const before = config.plugins.load.paths.length;
+          config.plugins.load.paths = config.plugins.load.paths.filter(
+            (p) => p !== pluginDir && p !== legacyPluginDir,
+          );
+          if (config.plugins.load.paths.length < before) configChanged = true;
+        }
+        configCleaned = configChanged;
+
+        let commandsRemoved = 0;
+        if (config.channels) {
+          for (const ch of Object.values(config.channels)) {
+            if (Array.isArray(ch.customCommands)) {
+              const before = ch.customCommands.length;
+              ch.customCommands = ch.customCommands.filter(
+                (c) => !skillNames.includes(c.command),
+              );
+              commandsRemoved += before - ch.customCommands.length;
+            }
+          }
+        }
+        commandsCleaned = commandsRemoved > 0;
+        if (commandsCleaned) configChanged = true;
+
+        if (configChanged) {
+          fs.writeFileSync(
+            openclawConfigPath,
+            `${JSON.stringify(config, null, 2)}\n`,
+          );
+        }
+      } catch {}
+    }
+
+    const configParts = [];
+    if (configCleaned) configParts.push("plugin config");
+    if (commandsCleaned) configParts.push("channel commands");
+    sp6.stop(
+      configParts.length > 0
+        ? `Cleaned openclaw.json (${configParts.join(", ")})`
+        : chalk.dim("No config changes needed"),
+    );
+
+    await sleep(200);
+
+    // Restart gateway
+    const sp7 = startSpinner("Restarting OpenClaw Gateway...");
+    await sleep(300);
+    let restarted = false;
+    try {
+      await execAsync("openclaw gateway restart", { timeout: 15000 });
+      restarted = true;
+    } catch {}
+
+    if (restarted) {
+      sp7.stop("Gateway restarted (plugin unloaded)");
+    } else {
+      sp7.fail(
+        chalk.dim("Could not restart gateway (restart manually if needed)"),
+      );
+    }
+
+    console.log();
+    await sleep(300);
+    console.log(`  ${chalk.green("\u2705")} Uninstall complete.`);
+    console.log();
+  });
+
+(async () => {
+  await program.parseAsync(process.argv);
+})();

package/lib/deps.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+"use strict";
+
+const { execSync } = require("child_process");
+const chalk = require("chalk");
+
+const DEPS = [
+  {
+    name: "openclaw",
+    check: "openclaw",
+    install: "npm i -g openclaw",
+    url: "https://openclaw.ai",
+    autoInstall: false,
+  },
+  {
+    name: "opencode",
+    check: "opencode",
+    install: "curl -fsSL https://opencode.ai/install | bash && source ~/.bashrc",
+    url: "https://opencode.ai",
+    autoInstall: true,
+  },
+  {
+    name: "tmux",
+    check: "tmux",
+    macOS: "brew install tmux",
+    linux: "sudo apt install -y tmux",
+    autoInstall: true,
+  },
+  {
+    name: "flock",
+    check: "flock",
+    macOS: "brew install flock",
+    linux: "sudo apt install -y util-linux",
+    autoInstall: true,
+  },
+];
+
+function whichBin(name) {
+  if (!/^[a-z0-9_-]+$/i.test(name)) return null;
+  try {
+    return execSync(`command -v ${name}`, { encoding: "utf8" }).trim();
+  } catch {
+    return null;
+  }
+}
+
+function detectPackageManager() {
+  const platform = process.platform;
+  if (platform === "darwin") {
+    return whichBin("brew") ? "brew" : null;
+  }
+  if (whichBin("apt")) return "apt";
+  if (whichBin("yum")) return "yum";
+  return null;
+}
+
+function checkAll() {
+  const results = [];
+  let allFound = true;
+
+  for (const dep of DEPS) {
+    const path = whichBin(dep.check);
+    results.push({ ...dep, path, found: !!path });
+    if (!path) allFound = false;
+  }
+
+  return { results, allFound };
+}
+
+function printStatus(results) {
+  for (const dep of results) {
+    if (dep.found) {
+      console.log(
+        `    ${chalk.green("\u2713")} ${dep.name.padEnd(10)} ${chalk.dim(dep.path)}`,
+      );
+    } else {
+      const cmd = getInstallCmd(dep);
+      console.log(
+        `    ${chalk.red("\u2717")} ${dep.name.padEnd(10)} ${chalk.red("not found")}`,
+      );
+      if (cmd) console.log(`      ${chalk.dim("Install:")} ${chalk.cyan(cmd)}`);
+    }
+  }
+}
+
+/**
+ * Get the install command for a dependency on the current platform.
+ */
+function getInstallCmd(dep) {
+  if (dep.install) return dep.install;
+
+  const platform = process.platform;
+  if (platform === "darwin") return dep.macOS;
+
+  if (dep.name === "tmux") {
+    const pm = detectPackageManager();
+    if (pm === "apt") return "sudo apt install -y tmux";
+    if (pm === "yum") return "sudo yum install -y tmux";
+    return null;
+  }
+
+  return dep.linux;
+}
+
+/**
+ * Attempt to install a single dependency.
+ * Returns the binary path on success, null on failure.
+ */
+function installDep(dep) {
+  const cmd = getInstallCmd(dep);
+  if (!cmd) return null;
+
+  try {
+    execSync(cmd, { stdio: "inherit", timeout: 120000 });
+    return whichBin(dep.check);
+  } catch {
+    return null;
+  }
+}
+
+module.exports = {
+  DEPS,
+  checkAll,
+  printStatus,
+  whichBin,
+  getInstallCmd,
+  installDep,
+};