clideck 1.22.6 → 1.23.1

package/.github/pull_request_template.md

@@ -0,0 +1,27 @@
+## What changed
+
+<!-- One or two sentences. What does this PR do? -->
+
+## Why
+
+<!-- What problem does this solve? Link to an issue or discussion if one exists. -->
+
+## How to verify
+
+<!--
+Steps to test this locally:
+1. Run `node server.js`
+2. Open http://localhost:4000
+3. ...
+-->
+
+## What's out of scope
+
+<!-- What did you intentionally NOT change? Helps reviewers stay focused. -->
+
+## Checklist
+
+- [ ] Tested locally with `node server.js`
+- [ ] One focused change, not bundled with unrelated fixes
+- [ ] No new external service dependencies
+- [ ] Does not read, store, or intercept agent prompts/responses

package/CONTRIBUTING.md

@@ -0,0 +1,53 @@
+# Contributing to CliDeck
+
+This document explains what we accept, what needs discussion first, and how to structure a PR so it gets reviewed fast.
+
+## What to contribute
+
+**Bug fixes and small improvements** — open a PR directly.
+Crashes, rendering glitches, typos, broken links, edge cases, performance fixes.
+
+**New features, architecture changes, or new agent presets** — [start a Discussion](https://github.com/rustykuntz/clideck/discussions) first.
+Describe the problem, your proposed approach, and any trade-offs. If the idea gets a thumbs up, then open a PR.
+
+**Plugins** — the best way to contribute new functionality.
+CliDeck has a plugin system so features can be added without touching core code. If your idea can be a plugin, it should be. See the [documentation](https://docs.clideck.dev/) for how to build one.
+
+## What we will reject
+
+- PRs that change multiple unrelated things. One change per PR.
+- PRs with no description of what changed or why.
+- Formatting-only changes (whitespace, semicolons, reordering imports).
+- Features that add external service dependencies or phone home.
+- Changes that break the zero-interference guarantee — CliDeck never reads, stores, or intercepts agent prompts and responses.
+
+## Before you open a PR
+
+1. **Test locally.** Run `node server.js`, open `http://localhost:4000`, and verify your change works.
+2. **Keep it focused.** If you found a bug while working on a feature, that's two PRs.
+3. **Match the existing style.** No linter is enforced, but stay consistent with surrounding code.
+4. **Don't bundle dependency changes** unless your PR specifically requires them.
+
+## PR structure
+
+Fill out the PR template. The key fields:
+
+- **What changed** — one or two sentences.
+- **Why** — the problem this solves.
+- **How to verify** — steps to confirm it works.
+- **What's out of scope** — what you intentionally did not change.
+
+Small PRs get reviewed faster. If your diff is over 300 lines, consider splitting it.
+
+## Built a fork?
+
+If you've forked CliDeck and built something — a new agent integration, a workflow improvement, a plugin — open a Discussion in **Show & Tell**. The best fork features get upstreamed.
+
+## Licensing of contributions
+
+By submitting a contribution that is accepted into the repository, you agree
+that it will be licensed under the MIT License.
+
+## Conduct
+
+Be constructive. Review comments are about the code, not the person. If a PR is rejected, the reason will be explained.

package/README.md

@@ -2,11 +2,14 @@
 
 One screen for all your AI coding agents.
 
+[Documentation](https://docs.clideck.dev/) | [Video Demo](https://youtu.be/hICrtjGAeDk) | [Website](https://clideck.dev/)
+
 ![CliDeck dashboard](assets/clideck-themes.jpg)
 
-You're running Claude Code, Codex, and Gemini CLI in separate terminals. You switch between them constantly, forget which one finished, and lose sessions when you close the lid. CliDeck puts them all on one screen with live status, so you always know what's happening.
+You're running Claude Code, Codex, Gemini CLI, and OpenCode in separate terminals. You switch between them constantly, forget which one finished, and lose sessions when you close the lid. CliDeck puts them all on one screen with live status, so you always know what's happening.
 
 CliDeck is a local dashboard that runs all your CLI agents in one browser tab. It tracks which agents are working, which are idle, and notifies you when they need attention. Everything runs on your machine — nothing leaves localhost.
+Switch between agents as easily as switching between chats.
 
 ## Quick Start
 
@@ -72,6 +75,10 @@ Full setup guides, agent configuration, and plugin development:
 
 **[Documentation](https://docs.clideck.dev/)**
 
+## Acknowledgments
+
+Built with [xterm.js](https://xtermjs.org/).
+
 ## License
 
-MIT
+MIT — see [LICENSE](LICENSE).

package/activity.js

@@ -51,6 +51,11 @@ function stop() {
   interval = null;
 }
 
+function isActive(id) {
+  const s = stream[id];
+  return s ? (Date.now() - s.lastOutAt < 2000) : false;
+}
+
 function clear(id) { delete net[id]; delete stream[id]; }
 
-module.exports = { start, stop, trackIn, trackOut, clear };
+module.exports = { start, stop, trackIn, trackOut, isActive, clear };

package/handlers.js

@@ -11,6 +11,23 @@ for (const p of presets) if (p.presetId === 'shell') p.command = defaultShell;
 const transcript = require('./transcript');
 const plugins = require('./plugin-loader');
 
+const opencodePluginDir = join(
+  process.platform === 'win32' ? (process.env.APPDATA || join(os.homedir(), 'AppData', 'Roaming')) : join(os.homedir(), '.config'),
+  'opencode', 'plugins'
+);
+// Resolve opencode preset paths for current platform
+for (const p of presets) {
+  if (p.presetId !== 'opencode') continue;
+  const bridgePath = join(opencodePluginDir, 'clideck-bridge.js');
+  if (p.pluginPath) p.pluginPath = bridgePath;
+  if (p.pluginSetup) {
+    const copyCmd = process.platform === 'win32'
+      ? `copy opencode-plugin\\clideck-bridge.js "${opencodePluginDir}\\"`
+      : `cp opencode-plugin/clideck-bridge.js ${opencodePluginDir}/`;
+    p.pluginSetup = `Install the CliDeck bridge plugin to enable real-time status and resume.\n\n${copyCmd}`;
+  }
+}
+
 // Check which agent binaries are available on PATH
 const whichCmd = process.platform === 'win32' ? 'where' : 'which';
 function checkAvailability() {
@@ -47,8 +64,7 @@ function detectTelemetryConfig(c) {
         detected = !!s.telemetry?.enabled && (s.telemetry?.otlpEndpoint || '').includes(`localhost:${port}`);
       } catch {}
     } else if (preset.presetId === 'opencode') {
-      const ocPlugins = join(home, '.config', 'opencode', 'plugins');
-      detected = existsSync(join(ocPlugins, 'clideck-bridge.js')) || existsSync(join(ocPlugins, 'termix-bridge.js'));
+      detected = existsSync(join(opencodePluginDir, 'clideck-bridge.js')) || existsSync(join(opencodePluginDir, 'termix-bridge.js'));
     } else { continue; }
     if (detected !== !!cmd.telemetryEnabled) {
       cmd.telemetryEnabled = detected;
@@ -60,14 +76,18 @@ function detectTelemetryConfig(c) {
   return changed;
 }
 
+function configForClient() {
+  return { ...cfg, pluginsDir: plugins.PLUGINS_DIR };
+}
+
 function onConnection(ws) {
   sessions.clients.add(ws);
 
-  ws.send(JSON.stringify({ type: 'config', config: cfg }));
+  ws.send(JSON.stringify({ type: 'config', config: configForClient() }));
   ws.send(JSON.stringify({ type: 'themes', themes }));
   ws.send(JSON.stringify({ type: 'presets', presets }));
   ws.send(JSON.stringify({ type: 'sessions', list: sessions.list() }));
-  ws.send(JSON.stringify({ type: 'sessions.resumable', list: sessions.getResumable() }));
+  ws.send(JSON.stringify({ type: 'sessions.resumable', list: sessions.getResumable(cfg) }));
   ws.send(JSON.stringify({ type: 'transcript.cache', cache: transcript.getCache() }));
   ws.send(JSON.stringify({ type: 'plugins', list: plugins.getInfo() }));
   sessions.sendBuffers(ws);
@@ -82,14 +102,20 @@ function onConnection(ws) {
       case 'session.restart': console.log('[handler] session.restart', msg.id); sessions.restart(msg, ws, cfg); break;
       case 'input':                sessions.input(msg); break;
       case 'session.statusReport':
-        if (sessions.getSessions().has(msg.id)) plugins.notifyStatus(msg.id, !!msg.working);
+        if (sessions.getSessions().has(msg.id)) {
+          plugins.notifyStatus(msg.id, !!msg.working);
+        }
+        break;
+      case 'terminal.buffer':
+        require('./transcript').storeBuffer(msg.id, msg.lines);
+        sessions.broadcast({ type: 'screen.updated', id: msg.id });
         break;
       case 'resize':               sessions.resize(msg); break;
       case 'rename':          sessions.rename(msg); break;
-      case 'close':           sessions.close(msg); break;
+      case 'close':           sessions.close(msg, cfg); break;
 
       case 'config.get':
-        ws.send(JSON.stringify({ type: 'config', config: cfg }));
+        ws.send(JSON.stringify({ type: 'config', config: configForClient() }));
         break;
 
       case 'checkAvailability':
@@ -98,10 +124,11 @@ function onConnection(ws) {
         break;
 
       case 'config.update':
+        delete msg.config.pluginsDir;
         cfg = { ...cfg, ...msg.config };
         detectTelemetryConfig(cfg);
         config.save(cfg);
-        sessions.broadcast({ type: 'config', config: cfg });
+        sessions.broadcast({ type: 'config', config: configForClient() });
         break;
 
       case 'session.theme': {
@@ -129,7 +156,7 @@ function onConnection(ws) {
           }
         }
         config.save(cfg);
-        sessions.broadcast({ type: 'config', config: cfg });
+        sessions.broadcast({ type: 'config', config: configForClient() });
         ws.send(JSON.stringify({
           type: 'telemetry.autosetup.result',
           presetId: msg.presetId,
@@ -159,7 +186,7 @@ function onConnection(ws) {
           }
         }
         config.save(cfg);
-        sessions.broadcast({ type: 'config', config: cfg });
+        sessions.broadcast({ type: 'config', config: configForClient() });
         break;
       }
 
@@ -185,11 +212,11 @@ function onConnection(ws) {
         if (!proj) break;
         // Kill all sessions in this project
         for (const s of sessions.list()) {
-          if (s.projectId === msg.id) sessions.close({ id: s.id });
+          if (s.projectId === msg.id) sessions.close({ id: s.id }, cfg);
         }
         cfg.projects = cfg.projects.filter(p => p.id !== msg.id);
         config.save(cfg);
-        sessions.broadcast({ type: 'config', config: cfg });
+        sessions.broadcast({ type: 'config', config: configForClient() });
         break;
       }
 
@@ -207,6 +234,55 @@ function onConnection(ws) {
         sessions.broadcast({ type: 'plugins', list: plugins.getInfo() });
         break;
 
+      case 'remote.status': {
+        let installed = false;
+        try { execFileSync(whichCmd, ['clideck-remote'], { stdio: 'ignore' }); installed = true; } catch {}
+        if (!installed) { ws.send(JSON.stringify({ type: 'remote.status', installed: false })); break; }
+        require('child_process').execFile('clideck-remote', ['status', '--json'], { timeout: 5000 }, (err, stdout) => {
+          if (err) { ws.send(JSON.stringify({ type: 'remote.status', installed: true })); return; }
+          try { ws.send(JSON.stringify({ type: 'remote.status', installed: true, ...JSON.parse(stdout) })); }
+          catch { ws.send(JSON.stringify({ type: 'remote.status', installed: true })); }
+        });
+        break;
+      }
+
+      case 'remote.pair': {
+        require('child_process').execFile('clideck-remote', ['pair', '--json'], { timeout: 15000 }, (err, stdout) => {
+          if (err) { ws.send(JSON.stringify({ type: 'remote.error', error: err.message })); return; }
+          try { ws.send(JSON.stringify({ type: 'remote.paired', ...JSON.parse(stdout) })); }
+          catch { ws.send(JSON.stringify({ type: 'remote.error', error: 'Invalid response from clideck-remote' })); }
+        });
+        break;
+      }
+
+      case 'remote.unpair': {
+        require('child_process').execFile('clideck-remote', ['unpair', '--json'], { timeout: 5000 }, (err) => {
+          if (err) {
+            ws.send(JSON.stringify({ type: 'remote.error', error: err.message }));
+          } else {
+            sessions.broadcast({ type: 'remote.unpaired' });
+          }
+        });
+        break;
+      }
+
+      case 'remote.getHistory': {
+        const turns = transcript.getScreenTurns(msg.id, sessions.getSessions().get(msg.id)?.presetId)
+          || transcript.getLastTurns(msg.id, msg.limit || 50);
+        ws.send(JSON.stringify({ type: 'remote.history', id: msg.id, turns: turns || [] }));
+        break;
+      }
+
+      case 'remote.install': {
+        const proc = require('child_process').spawn('npm', ['install', '-g', 'clideck-remote'], {
+          shell: true, stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        proc.stdout.on('data', d => ws.send(JSON.stringify({ type: 'remote.install.progress', text: d.toString() })));
+        proc.stderr.on('data', d => ws.send(JSON.stringify({ type: 'remote.install.progress', text: d.toString() })));
+        proc.on('close', code => ws.send(JSON.stringify({ type: 'remote.install.done', success: code === 0 })));
+        break;
+      }
+
       default:
         if (msg.type?.startsWith('plugin.')) plugins.handleMessage(msg);
         break;
@@ -256,14 +332,13 @@ function applyTelemetryConfig(preset) {
     }
 
     if (preset.presetId === 'opencode') {
-      const pluginDir = join(home, '.config', 'opencode', 'plugins');
       const src = join(__dirname, 'opencode-plugin', 'clideck-bridge.js');
-      mkdirSync(pluginDir, { recursive: true });
-      copyFileSync(src, join(pluginDir, 'clideck-bridge.js'));
+      mkdirSync(opencodePluginDir, { recursive: true });
+      copyFileSync(src, join(opencodePluginDir, 'clideck-bridge.js'));
       // Remove old termix-bridge.js if present
-      const old = join(pluginDir, 'termix-bridge.js');
+      const old = join(opencodePluginDir, 'termix-bridge.js');
       if (existsSync(old)) try { unlinkSync(old); } catch {}
-      return { success: true, message: 'Installed bridge plugin to ~/.config/opencode/plugins/' };
+      return { success: true, message: `Installed bridge plugin to ${opencodePluginDir}` };
     }
 
     return { success: false, message: `No auto-setup for ${preset.presetId}` };
@@ -297,9 +372,8 @@ function removeTelemetryConfig(preset) {
     }
 
     if (preset.presetId === 'opencode') {
-      const dir = join(home, '.config', 'opencode', 'plugins');
-      try { unlinkSync(join(dir, 'clideck-bridge.js')); } catch {}
-      try { unlinkSync(join(dir, 'termix-bridge.js')); } catch {}
+      try { unlinkSync(join(opencodePluginDir, 'clideck-bridge.js')); } catch {}
+      try { unlinkSync(join(opencodePluginDir, 'termix-bridge.js')); } catch {}
       return { success: true, message: 'Removed bridge plugin' };
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clideck",
-  "version": "1.22.6",
+  "version": "1.23.1",
   "description": "One screen for all your AI coding agents — run, monitor, and manage multiple CLI agents from a single browser tab",
   "main": "server.js",
   "bin": {

package/plugin-loader.js

@@ -32,6 +32,7 @@ const plugins = new Map();
 const inputHooks = [];
 const outputHooks = [];
 const statusHooks = [];
+const transcriptHooks = [];
 const sessionStatus = new Map(); // sessionId → boolean (dedup multi-client reports)
 const frontendHandlers = new Map();
 let broadcastFn = null;
@@ -41,7 +42,7 @@ let saveConfigFn = null;
 const settingsChangeHandlers = new Map(); // pluginId → [fn]
 
 function removeHooks(pluginId) {
-  for (const arr of [inputHooks, outputHooks, statusHooks]) {
+  for (const arr of [inputHooks, outputHooks, statusHooks, transcriptHooks]) {
     for (let i = arr.length - 1; i >= 0; i--) {
       if (arr[i].pluginId === pluginId) arr.splice(i, 1);
     }
@@ -111,6 +112,7 @@ function buildApi(pluginId, pluginDir, state) {
     onSessionInput(fn) { inputHooks.push({ pluginId, fn }); },
     onSessionOutput(fn) { outputHooks.push({ pluginId, fn }); },
     onStatusChange(fn) { statusHooks.push({ pluginId, fn }); },
+    onTranscriptEntry(fn) { transcriptHooks.push({ pluginId, fn }); },
 
     sendToFrontend(event, data = {}) {
       broadcastFn?.({ ...data, type: `plugin.${pluginId}.${event}` });
@@ -184,6 +186,13 @@ function notifyStatus(id, working) {
   }
 }
 
+function notifyTranscript(id, role, text) {
+  for (const h of transcriptHooks) {
+    try { h.fn(id, role, text); }
+    catch (e) { console.error(`[plugin:${h.pluginId}] transcript error: ${e.message}`); }
+  }
+}
+
 function updateSetting(pluginId, key, value) {
   // Validate plugin exists (also prevents __proto__ pollution — Map lookup returns undefined)
   const plugin = plugins.get(pluginId);
@@ -241,6 +250,8 @@ function getInfo() {
     id: p.manifest.id,
     name: p.manifest.name,
     version: p.manifest.version,
+    author: p.manifest.author || '',
+    description: p.manifest.description || '',
     settings: p.manifest.settings || [],
     settingValues: cfg?.pluginSettings?.[p.manifest.id] || {},
     actions: p.actions,
@@ -279,7 +290,8 @@ function shutdown() {
 function clearStatus(id) { sessionStatus.delete(id); }
 
 module.exports = {
+  PLUGINS_DIR,
   init, shutdown,
-  transformInput, notifyOutput, notifyStatus, clearStatus,
+  transformInput, notifyOutput, notifyStatus, notifyTranscript, clearStatus,
   handleMessage, updateSetting, getInfo, resolveFile,
 };

package/plugins/trim-clip/clideck-plugin.json

@@ -1,7 +1,9 @@
 {
   "id": "trim-clip",
   "name": "Trim Clip",
-  "version": "1.1.0",
+  "version": "1.2.0",
+  "author": "CliDeck",
+  "description": "Copy selected terminal text with trailing whitespace trimmed",
   "settings": [
     {
       "key": "enabled",

package/plugins/voice-input/clideck-plugin.json

@@ -1,7 +1,9 @@
 {
   "id": "voice-input",
   "name": "Voice Input",
-  "version": "1.1.0",
+  "version": "1.2.0",
+  "author": "CliDeck",
+  "description": "Dictate prompts with your voice using Whisper speech-to-text",
   "settings": [
     {
       "key": "enabled",