clideck 1.25.6 → 1.25.8

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/activity.js

@@ -56,6 +56,8 @@ function isActive(id) {
   return s ? (Date.now() - s.lastOutAt < 2000) : false;
 }
 
+function lastOutputAt(id) { return stream[id]?.lastOutAt || 0; }
+
 function clear(id) { delete net[id]; delete stream[id]; }
 
-module.exports = { start, stop, trackIn, trackOut, isActive, clear };
+module.exports = { start, stop, trackIn, trackOut, isActive, lastOutputAt, clear };

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.6",
+  "version": "1.25.8",
   "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/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

@@ -2,8 +2,10 @@
 // CLI agents export telemetry events here; we capture agent session IDs
 // (for resume) and detect whether telemetry is configured (setup prompts).
 
+const ioActivity = require('./activity');
 const activity = new Map(); // sessionId → has received events
 const pendingSetup = new Map(); // sessionId → timer (waiting for first event)
+const pendingIdle = new Map(); // sessionId → timer (api_request → confirm idle after output silence)
 let broadcastFn = null;
 let sessionsFn = null;
 
@@ -69,6 +71,8 @@ function handleLogs(req, res) {
         const attrs = parseAttrs(lr.attributes);
 
         const eventName = attrs['event.name'];
+        // Debug telemetry logs — uncomment as needed, do not delete
+        // if (serviceName === 'claude-code' && eventName) console.log(`[telemetry:claude] ${eventName}`);
         // if (serviceName === 'codex_cli_rs' && eventName) console.log(`[telemetry:codex] ${eventName}`);
         // if (serviceName === 'gemini-cli' && eventName) console.log(`[telemetry:gemini] ${eventName}`);
 
@@ -77,11 +81,12 @@ function handleLogs(req, res) {
         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.
+        // Claude: telemetry-only status. api_request → pending idle (confirm after 1s output silence, expire after 6s).
         if (serviceName === 'claude-code' && eventName) {
           if (eventName === 'api_request') {
-            broadcastFn?.({ type: 'session.status', id: resolvedId, working: false, source: 'telemetry' });
+            startPendingIdle(resolvedId);
           } else if (eventName !== 'user_prompt') {
+            cancelPendingIdle(resolvedId);
             broadcastFn?.({ type: 'session.status', id: resolvedId, working: true, source: 'telemetry' });
           }
         }
@@ -142,8 +147,29 @@ function cancelPendingSetup(sessionId) {
   }
 }
 
+// Pending idle: api_request starts a check loop. Confirm idle after 1s of output silence. Expire after 6s.
+function startPendingIdle(id) {
+  cancelPendingIdle(id);
+  const started = Date.now();
+  const check = setInterval(() => {
+    const elapsed = Date.now() - started;
+    if (elapsed > 6000) { cancelPendingIdle(id); return; }
+    if (Date.now() - Math.max(started, ioActivity.lastOutputAt(id)) >= 1000) {
+      cancelPendingIdle(id);
+      broadcastFn?.({ type: 'session.status', id, working: false, source: 'telemetry' });
+    }
+  }, 250);
+  pendingIdle.set(id, check);
+}
+
+function cancelPendingIdle(id) {
+  const timer = pendingIdle.get(id);
+  if (timer) { clearInterval(timer); pendingIdle.delete(id); }
+}
+
 function clear(id) {
   activity.delete(id);
+  cancelPendingIdle(id);
   const pending = pendingSetup.get(id);
   if (pending) { clearTimeout(pending.timer); pendingSetup.delete(id); }
 }

package/transcript.js

@@ -302,4 +302,28 @@ function clear(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,43 @@
+CliDeck — Work Plan
+======================
+
+## Structured menu events — DONE
+
+Moved interactive menu detection from mobile-side parsing to CliDeck desktop.
+Menus detected server-side, broadcast as structured data, rendered on both desktop and mobile.
+
+Implementation:
+- transcript.js: detectMenu(lines, presetId) — walks upward from footer/esc anchor,
+  collects sequential numbered choices, requires agent-specific marker (❯/›/●) on at least one line.
+  Handles footerless Gemini menus via (esc) in choice text.
+- handlers.js: after terminal.buffer capture, runs detectMenu, broadcasts session.menu
+  with structured choices. Forces idle when menu detected. Deduplicates via _menuKey on session.
+- sessions.js: list() includes menu state for daemon reconnect.
+- daemon.js: forwards session.menu to mobile, caches per-session menu state,
+  sends on subscribe, clears on working status.
+- mobile index.html: renderMenu(choices) replaces 28-line updateChoices parser.
+  Menu state comes from session.menu event, no local parsing.
+
+## Pending idle for Claude — DONE
+
+Claude's api_request no longer flips to idle immediately. Instead:
+- api_request → starts pending idle window (polls every 250ms)
+- Confirm idle: 1s of no PTY output (measured from max(started, lastOutputAt))
+- Cancel: any new telemetry event, or 6s timeout
+- activity.js: exposes lastOutputAt(id) — timestamp of last PTY output per session
+- telemetry-receiver.js: startPendingIdle/cancelPendingIdle manage the window
+
+Why: api_request fires between tool calls mid-work, not just at end-of-turn.
+Immediate idle caused false status flickers. The 1s output silence confirms
+the agent is truly waiting for user input.
+
+## Future: desktop sidebar menu preview
+
+Show "please make a choice" or choice labels in the desktop session list
+when a menu is active. Infrastructure is ready (session.menu broadcast exists).
+
+## Future: OpenCode menu support
+
+OpenCode not yet in MENU_MARKERS. Need to determine:
+- Does OpenCode expose menu events via bridge plugin API?
+- If not, what marker character does OpenCode use for interactive menus?