clideck 1.25.5 → 1.25.7

package/README.md

@@ -1,79 +1,81 @@
-# CliDeck
+<img src="public/img/clideck-logo-icon.png" width="48" alt="clideck logo">
 
-One screen for all your AI coding agents.
+# clideck
+
+> **Formerly `termix-cli`** — if you arrived here from an old link, you're in the right place. The project has been renamed to **CliDeck**. Update your install: `npm install -g clideck`
+
+Manage your AI agents like WhatsApp chats.
 
 [Documentation](https://docs.clideck.dev/) | [Video Demo](https://youtu.be/hICrtjGAeDk) | [Website](https://clideck.dev/)
 
-![CliDeck dashboard](assets/clideck-themes.jpg)
+![clideck dashboard](assets/clideck-themes.jpg)
 
-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.
+You run Claude Code, Codex, Gemini CLI in separate terminals. You alt-tab between them, forget which one finished, lose sessions when you close the lid.
 
-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.
+clideck puts all your agents in one screen — a sidebar with every session, live status, last message preview, and timestamps. Click a session, you're in its terminal. Exactly like switching between chats.
+
+Native terminals. Your keystrokes go straight to the agent, nothing in between. clideck never reads your prompts or output.
 
 ## Quick Start
 
 ```bash
-npm install -g clideck
-clideck
+npx clideck
 ```
 
 Open [http://localhost:4000](http://localhost:4000). Click **+**, pick an agent, start working.
 
-Or run directly without installing:
+Or install globally:
 
 ```bash
-npx clideck
+npm install -g clideck
+clideck
 ```
 
 ## What You Get
 
-- **Live status** — see which agents are working and which are done, without checking each terminal
-- **Session resume** — close CliDeck, reopen it tomorrow, resume your Claude Code conversation where you left off
-- **Notifications** — browser and sound alerts the moment an agent finishes or needs input
+- **Live working/idle status** — see which agent is thinking and which is waiting for you, without checking each terminal
+- **Session resume** — close clideck, reopen it tomorrow, pick up where you left off
+- **Notifications** — browser and sound alerts when an agent finishes or needs input
 - **Message previews** — latest output from each agent, right in the sidebar
 - **Projects** — group sessions by project with drag-and-drop
 - **Search** — find any session by name or scroll back through transcript content
-- **Prompt Library** — save reusable prompts and paste them into any terminal by typing `//`
-- **Plugins** — ships with Voice Input and Trim Clip. Build your own with the plugin API
-- **15 themes** — dark and light built-in, plus custom theme support
-- **Zero interference** — native PTY terminals, your keystrokes go straight to the agent, nothing in between
+- **Prompt Library** — save reusable prompts, type `//` in any terminal to paste them
+- **Plugins** — ships with Voice Input and Trim Clip, or build your own
+- **15 themes** — dark and light, plus custom theme support
+
+## Mobile Access
+
+Check on your agents from your phone. Start a task, walk away, glance at your phone — see who's done, who's working, who needs input. Pair with one QR scan, no account needed. E2E encrypted — the relay cannot read your code.
 
 ## Supported Agents
 
-CliDeck auto-detects whether each agent is working or idle:
+clideck auto-detects whether each agent is working or idle:
 
 | Agent | Status detection | Setup |
 |-------|-----------------|-------|
 | **Claude Code** | Automatic | Nothing to configure |
-| **Codex** | Automatic | One-click setup in CliDeck |
-| **Gemini CLI** | Automatic | One-click setup in CliDeck |
-| **OpenCode** | Via plugin bridge | One-click setup in CliDeck |
+| **Codex** | Automatic | One-click setup in clideck |
+| **Gemini CLI** | Automatic | One-click setup in clideck |
+| **OpenCode** | Via plugin bridge | One-click setup in clideck |
 | **Shell** | I/O activity only | None |
 
-Claude Code works out of the box. Other agents need a one-time configuration that CliDeck walks you through.
+Claude Code works out of the box. Other agents need a one-time setup that clideck walks you through.
 
 ## How It Works
 
-Each agent runs in a native terminal (PTY). CliDeck receives lightweight status signals from agents via OpenTelemetry — it sees *that* an agent is working, not *what* it's working on. Your prompts and responses are never read or stored by CliDeck.
-
-OpenTelemetry runs locally between the agent and CliDeck. No data is collected, transmitted, or stored outside your machine.
-
-## Prompt Library
-
-Save prompts you use often and paste them into any terminal session instantly. Open the Prompts panel from the sidebar, click **+** to add a prompt with a name and text.
+Each agent runs in a real terminal (PTY) on your machine. clideck receives lightweight status signals via OpenTelemetry — it knows *that* an agent is working, not *what* it's working on.
 
-To use a prompt, type `//` in any terminal — an autocomplete dropdown appears. Type a few letters to filter, arrow keys to navigate, Enter to paste. The prompt text is sent directly to the active terminal.
+Everything runs locally. No data is collected, transmitted, or stored outside your machine.
 
 ## Platform Support
 
-Tested on **macOS** and **Windows**. Works in any modern browser. Linux: untested — if you try it, open an issue and let me know.
+Tested on **macOS** and **Windows**. Works in any modern browser. Linux: untested — if you try it, open an issue.
 
 ## Documentation
 
 Full setup guides, agent configuration, and plugin development:
 
-**[Documentation](https://docs.clideck.dev/)**
+**[docs.clideck.dev](https://docs.clideck.dev/)**
 
 ## Acknowledgments
 

package/handlers.js

@@ -134,10 +134,21 @@ function onConnection(ws) {
           plugins.notifyStatus(msg.id, !!msg.working);
         }
         break;
-      case 'terminal.buffer':
+      case 'terminal.buffer': {
         require('./transcript').storeBuffer(msg.id, msg.lines);
         sessions.broadcast({ type: 'screen.updated', id: msg.id });
+        const sess = sessions.getSessions().get(msg.id);
+        if (sess) {
+          const choices = require('./transcript').detectMenu(msg.lines, sess.presetId);
+          const key = choices ? JSON.stringify(choices) : '';
+          if (key !== (sess._menuKey || '')) {
+            sess._menuKey = key;
+            sessions.broadcast({ type: 'session.menu', id: msg.id, choices: choices || [] });
+            if (choices) sessions.broadcast({ type: 'session.status', id: msg.id, working: false, source: 'menu' });
+          }
+        }
         break;
+      }
       case 'resize':               sessions.resize(msg); break;
       case 'rename':          sessions.rename(msg); break;
       case 'close':           sessions.close(msg, cfg); break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clideck",
-  "version": "1.25.5",
+  "version": "1.25.7",
   "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/public/js/terminals.js

@@ -340,24 +340,26 @@ export function addTerminal(id, name, themeId, commandId, projectId, muted, last
 
   // [SCREEN-CAPTURE] extract terminal buffer when BOTH idle AND render-silent (2s)
   // Decoupled from status: telemetry knows when agent is done, onRender knows when terminal is done
+  const _telemetryOnly = cmd?.presetId === 'claude-code' || cmd?.presetId === 'codex' || cmd?.presetId === 'gemini-cli';
   let _screenTimer = null, _renderSilent = false;
   function _tryScreenCapture() {
     const entry = state.terms.get(id);
-    if (!entry?.pendingScreenCapture || !_renderSilent || !entry.term) return;
+    if (!entry?.pendingScreenCapture || (!_renderSilent && !_telemetryOnly) || !entry.term) return;
     entry.pendingScreenCapture = false;
     const buf = entry.term.buffer.active;
     const lines = [];
     for (let i = 0; i < buf.length; i++) { const line = buf.getLine(i); if (line) lines.push(line.translateToString(true)); }
     send({ type: 'terminal.buffer', id, lines });
   }
+  let _idleTimer = null, _workTimer = null, _lastTyping = 0, _lastRender = 0;
+  term.onData(() => { _lastTyping = Date.now(); });
   term.onRender(() => {
+    _lastRender = Date.now();
     _renderSilent = false;
     clearTimeout(_screenTimer);
     _screenTimer = setTimeout(() => { _renderSilent = true; _tryScreenCapture(); }, 2000);
   });
-  let _idleTimer = null, _workTimer = null, _lastTyping = 0;
-  term.onData(() => { _lastTyping = Date.now(); });
-  term.onWriteParsed(() => { if (Date.now() - _lastTyping < 500) return; const entry = state.terms.get(id); if (entry) entry.lastRenderAt = Date.now(); if (!_workTimer) _workTimer = setTimeout(() => { _workTimer = null; setStatus(id, true); }, 1000); clearTimeout(_idleTimer); _idleTimer = setTimeout(() => { clearTimeout(_workTimer); _workTimer = null; setStatus(id, false); send({ type: 'session.statusReport', id, working: false }); }, 1500); });
+  term.onWriteParsed(() => { if (Date.now() - _lastTyping < 500) return; const entry = state.terms.get(id); if (entry) entry.lastRenderAt = Date.now(); if (_telemetryOnly) return; if (!_workTimer) _workTimer = setTimeout(() => { _workTimer = null; if (Date.now() - _lastRender < 500) setStatus(id, true); }, 1500); clearTimeout(_idleTimer); _idleTimer = setTimeout(() => { clearTimeout(_workTimer); _workTimer = null; setStatus(id, false); send({ type: 'session.statusReport', id, working: false }); }, 1500); });
 
   // Expose capture function so setStatus can trigger it when idle arrives after render silence
   setTimeout(() => { const e = state.terms.get(id); if (e) e.tryScreenCapture = _tryScreenCapture; }, 0);

package/sessions.js

@@ -282,6 +282,7 @@ function list() {
     id, name: s.name, themeId: s.themeId, commandId: s.commandId, presetId: s.presetId || 'shell', projectId: s.projectId, muted: !!s.muted,
     // Last preview text for sidebar display on reconnect
     lastPreview: s.lastPreview || '', lastActivityAt: s.lastActivityAt || null,
+    menu: s._menuKey ? JSON.parse(s._menuKey) : undefined,
   }));
 }
 

package/telemetry-receiver.js

@@ -32,7 +32,7 @@ function handleLogs(req, res) {
     const resAttrs = parseAttrs(rl.resource?.attributes);
     const sessionId = resAttrs['clideck.session_id'];
 
-    // DEBUG: log all incoming telemetry with resource attributes
+    // service.name values: claude-code, codex_cli_rs, gemini-cli
     const serviceName = resAttrs['service.name'] || 'unknown';
     let resolvedId = sessionId;
 
@@ -69,14 +69,39 @@ function handleLogs(req, res) {
         const attrs = parseAttrs(lr.attributes);
 
         const eventName = attrs['event.name'];
-        if (eventName) console.log(`[telemetry] ${resolvedId?.slice(0,8)} ${eventName}`);
+        // if (serviceName === 'codex_cli_rs' && eventName) console.log(`[telemetry:codex] ${eventName}`);
+        // if (serviceName === 'gemini-cli' && eventName) console.log(`[telemetry:gemini] ${eventName}`);
 
-        // Telemetry: only used for working=true (user prompt). Idle is handled by frontend write-silence.
+        // Telemetry-based status
         const startEvents = new Set(['user_prompt', 'gemini_cli.user_prompt', 'codex.user_prompt']);
-
         if (startEvents.has(eventName)) {
           broadcastFn?.({ type: 'session.status', id: resolvedId, working: true, source: 'telemetry' });
         }
+        // Claude: telemetry-only status. user_prompt/any event → working, api_request → idle.
+        if (serviceName === 'claude-code' && eventName) {
+          if (eventName === 'api_request') {
+            broadcastFn?.({ type: 'session.status', id: resolvedId, working: false, source: 'telemetry' });
+          } else if (eventName !== 'user_prompt') {
+            broadcastFn?.({ type: 'session.status', id: resolvedId, working: true, source: 'telemetry' });
+          }
+        }
+        // Codex: telemetry-only status. codex.user_prompt/any event → working, codex.sse_event → idle.
+        if (serviceName === 'codex_cli_rs' && eventName) {
+          if (eventName === 'codex.sse_event') {
+            broadcastFn?.({ type: 'session.status', id: resolvedId, working: false, source: 'telemetry' });
+          } else if (eventName !== 'codex.user_prompt') {
+            broadcastFn?.({ type: 'session.status', id: resolvedId, working: true, source: 'telemetry' });
+          }
+        }
+        // Gemini: telemetry-only status. Whitelisted events → working, api_response (role=main) → idle.
+        if (serviceName === 'gemini-cli' && eventName) {
+          if (eventName === 'gemini_cli.api_response' && attrs['role'] === 'main') {
+            broadcastFn?.({ type: 'session.status', id: resolvedId, working: false, source: 'telemetry' });
+          } else if (eventName === 'gemini_cli.api_request' || eventName === 'gemini_cli.model_routing'
+            || (eventName === 'gemini_cli.api_response' && attrs['role'] !== 'main')) {
+            broadcastFn?.({ type: 'session.status', id: resolvedId, working: true, source: 'telemetry' });
+          }
+        }
 
         const agentSessionId = attrs['session.id'] || attrs['conversation.id'];
         if (agentSessionId && sess) {

package/transcript.js

@@ -10,6 +10,7 @@ const inputBuf = {};
 const outputBuf = {};
 const cache = {};
 const prefixes = {};
+const userTexts = {}; // sessionId → [text, ...] — user prompts for parser matching
 let broadcast = null;
 let notifyPlugin = null;
 
@@ -71,7 +72,7 @@ function trackInput(id, data) {
     }
     if (ch === '\r' || ch === '\n') {
       const line = buf.text.trim();
-      if (line) store(id, 'user', line);
+      if (line) { store(id, 'user', line); if (!userTexts[id]) userTexts[id] = []; userTexts[id].push(line); }
       buf.text = '';
     } else if (ch === '\x7f' || ch === '\x08') {
       const chars = Array.from(buf.text);
@@ -127,14 +128,21 @@ function getScreen(id) {
 
 // Per-agent screen parsers. Each returns [{role, text}] from .screen content.
 const agentParsers = {
-  'claude-code': (lines) => {
+  'claude-code': (lines, id) => {
+    const known = userTexts[id]?.length ? new Set(userTexts[id]) : null;
     const turns = [];
     let current = null;
     for (const line of lines) {
-      const m = line.match(/^(?:[│ ]\s*)?([❯›]|[⏺•●])\s(.*)$/);
-      if (m) {
+      const agent = line.match(/^(?:[│ ]\s*)?[⏺•●]\s(.*)$/);
+      if (agent) {
         if (current) { current.text = current.text.replace(/\n+$/, ''); turns.push(current); }
-        current = { role: m[1] === '❯' || m[1] === '›' ? 'user' : 'agent', text: m[2] };
+        current = { role: 'agent', text: agent[1] };
+        continue;
+      }
+      const userM = line.match(/^(?:[│ ]\s*)?[❯›]\s(.*)$/);
+      if (userM && (known ? known.has(userM[1].trim()) : true)) {
+        if (current) { current.text = current.text.replace(/\n+$/, ''); turns.push(current); }
+        current = { role: 'user', text: userM[1] };
         continue;
       }
       if (!current) continue;
@@ -146,14 +154,21 @@ const agentParsers = {
     if (current) { current.text = current.text.replace(/\n+$/, ''); turns.push(current); }
     return turns.length >= 2 ? turns : null;
   },
-  'codex': (lines) => {
+  'codex': (lines, id) => {
+    const known = userTexts[id]?.length ? new Set(userTexts[id]) : null;
     const turns = [];
     let current = null;
     for (const line of lines) {
-      const m = line.match(/^(?:│\s*)?([›•])\s(.*)$/);
-      if (m) {
+      const agent = line.match(/^(?:│\s*)?•\s(.*)$/);
+      if (agent) {
+        if (current) { current.text = current.text.replace(/\n+$/, ''); turns.push(current); }
+        current = { role: 'agent', text: agent[1] };
+        continue;
+      }
+      const userM = line.match(/^(?:│\s*)?›\s(.*)$/);
+      if (userM && (known ? known.has(userM[1].trim()) : true)) {
         if (current) { current.text = current.text.replace(/\n+$/, ''); turns.push(current); }
-        current = { role: m[1] === '›' ? 'user' : 'agent', text: m[2] };
+        current = { role: 'user', text: userM[1] };
         continue;
       }
       if (!current) continue;
@@ -165,7 +180,8 @@ const agentParsers = {
     if (current) { current.text = current.text.replace(/\n+$/, ''); turns.push(current); }
     return turns.length >= 2 ? turns : null;
   },
-  'gemini-cli': (lines) => {
+  'gemini-cli': (lines, id) => {
+    const known = userTexts[id]?.length ? new Set(userTexts[id]) : null;
     const geminiChrome = t => {
       const s = t.trim();
       return /^shift\+tab to accept/i.test(s)
@@ -180,11 +196,12 @@ const agentParsers = {
     let current = null;
     for (const line of lines) {
       if (geminiChrome(line)) continue;
-      const isUser = line.startsWith(' > ');
       const isAgent = line.startsWith('✦ ');
+      const userM = line.startsWith(' > ') ? line.slice(3) : null;
+      const isUser = userM && (known ? known.has(userM.trim()) : true);
       if (isUser || isAgent) {
         if (current) { current.text = current.text.replace(/\n+$/, ''); turns.push(current); }
-        current = { role: isUser ? 'user' : 'agent', text: isUser ? line.slice(3) : line.slice(2) };
+        current = { role: isUser ? 'user' : 'agent', text: isUser ? userM : line.slice(2) };
         continue;
       }
       if (!current) continue;
@@ -243,7 +260,7 @@ function getScreenTurns(id, agent) {
   if (!screen) return null;
   const lines = screen.split('\n');
   const parser = agentParsers[agent];
-  const turns = parser ? parser(lines) : anchorParse(id, lines);
+  const turns = parser ? parser(lines, id) : anchorParse(id, lines);
   // Drop trailing user turn — it's the empty prompt or unanswered input
   if (turns?.length && turns[turns.length - 1].role === 'user') turns.pop();
   return turns?.length >= 2 ? turns : null;
@@ -281,7 +298,32 @@ function clear(id) {
   }
   delete cache[id];
   delete prefixes[id];
+  delete userTexts[id];
   try { unlinkSync(join(DIR, `${id}.screen`)); } catch {}
 }
 
-module.exports = { init, trackInput, trackOutput, storeBuffer, getScreen, getScreenTurns, getLastTurns, getCache, clear, setPrefix };
+// Detect interactive menus from raw screen lines. Returns [{value, label, selected}] or null.
+// Finds the footer line, then walks upward collecting only the contiguous menu block.
+const MENU_MARKERS = { 'claude-code': /[❯›]/, codex: /[›❯]/, 'gemini-cli': /●/ };
+const MENU_CHOICE_RE = /^\s*(?:[│❯›●•]\s+)*(\d+)\.\s+(.+)$/;
+function detectMenu(lines, presetId) {
+  const marker = MENU_MARKERS[presetId];
+  if (!marker) return null;
+  let footerIdx = -1;
+  for (let i = lines.length - 1; i >= 0; i--) {
+    if (/\besc\b|\(esc\)/i.test(lines[i])) { footerIdx = MENU_CHOICE_RE.test(lines[i]) ? i + 1 : i; break; }
+  }
+  if (footerIdx < 0) return null;
+  const choices = [];
+  for (let i = footerIdx - 1; i >= 0; i--) {
+    if (!lines[i].trim() || /^[│\s]+$/.test(lines[i])) continue;
+    const m = lines[i].match(MENU_CHOICE_RE);
+    if (!m) break;
+    if (choices.length && +m[1] >= +choices[0].value) break;
+    choices.unshift({ value: m[1], label: m[2].trim(), selected: marker.test(lines[i]) });
+  }
+  if (!choices.some(c => c.selected)) return null;
+  return choices.length ? choices : null;
+}
+
+module.exports = { init, trackInput, trackOutput, storeBuffer, getScreen, getScreenTurns, getLastTurns, getCache, clear, setPrefix, detectMenu };

package/workplan.txt

@@ -0,0 +1,28 @@
+CliDeck — Future Tasks
+======================
+
+## Structured menu events
+
+Move interactive menu detection from mobile-side parsing to CliDeck desktop.
+Detect menus server-side, broadcast as structured data, render on both desktop and mobile.
+
+Why:
+- Single source of truth — detect once, consume everywhere
+- Enables desktop sidebar preview ("please make a choice")
+- Opens the door to raw ANSI-based detection (mobile never sees PTY bytes)
+- Fixes stuck "working" status when agent shows a menu: no telemetry event fires for
+  "waiting for user input", so CliDeck never flips to idle and never sends the notification.
+  Menu detection can double as an idle signal — if a menu is detected, force status to idle.
+
+Steps:
+1. Add menu detection in CliDeck where screen parsing already happens
+2. Store per-session menu state (choices, selected, footer)
+3. Detect menu appearance and disappearance, broadcast session.menu events
+4. Show "make a choice" preview in desktop session list
+5. Daemon forwards session.menu to mobile
+6. Remove mobile-side menu parsing, render from structured state instead
+
+Notes:
+- Detection heuristic stays the same (footer + numbered lines) unless ANSI-based approach is pursued
+- Currently mobile detection works fine with regex fix + "Esc to cancel" footer check
+- No agent-side telemetry event exists for menus — heuristic is the only option for now