@wong2kim/wmux 1.0.0 → 1.0.1

package/dist/mcp/shared/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ENV_KEYS = exports.PIPE_NAME = exports.IPC = void 0;
+exports.ENV_KEYS = exports.IPC = void 0;
 exports.getPipeName = getPipeName;
 exports.getAuthTokenPath = getAuthTokenPath;
 // IPC Channel names
@@ -11,6 +11,8 @@ exports.IPC = {
     PTY_DISPOSE: 'pty:dispose',
     PTY_DATA: 'pty:data',
     PTY_EXIT: 'pty:exit',
+    PTY_LIST: 'pty:list',
+    PTY_RECONNECT: 'pty:reconnect',
     SHELL_LIST: 'shell:list',
     SESSION_SAVE: 'session:save',
     SESSION_LOAD: 'session:load',
@@ -24,6 +26,8 @@ exports.IPC = {
     // Clipboard (main process bridge)
     CLIPBOARD_WRITE: 'clipboard:write',
     CLIPBOARD_READ: 'clipboard:read',
+    CLIPBOARD_READ_IMAGE: 'clipboard:read-image',
+    CLIPBOARD_HAS_IMAGE: 'clipboard:has-image',
     // Phase 4: Auto updater
     UPDATE_CHECK: 'update:check',
     UPDATE_AVAILABLE: 'update:available',
@@ -33,12 +37,21 @@ exports.IPC = {
     UPDATE_INSTALL: 'update:install',
     // Settings sync (renderer → main)
     TOAST_ENABLED: 'settings:toast-enabled',
+    // Agent critical action approval
+    APPROVAL_REQUEST: 'approval:request',
+    // File system
+    FS_READ_DIR: 'fs:read-dir',
+    FS_READ_FILE: 'fs:read-file',
+    FS_WATCH: 'fs:watch',
+    FS_UNWATCH: 'fs:unwatch',
+    FS_CHANGED: 'fs:changed',
 };
-// Named Pipe path for wmux API
+// Named Pipe / Unix socket path for wmux API
 // Fixed name so MCP clients (e.g. Claude Code) can reconnect across wmux restarts
-exports.PIPE_NAME = '\\\\.\\pipe\\wmux';
 function getPipeName() {
-    return exports.PIPE_NAME;
+    if (process.platform === 'win32')
+        return '\\\\.\\pipe\\wmux';
+    return '/tmp/wmux.sock';
 }
 // Environment variable names injected into PTY sessions
 exports.ENV_KEYS = {

package/package.json

@@ -1,84 +1,96 @@
-{
-  "name": "@wong2kim/wmux",
-  "productName": "wmux",
-  "version": "1.0.0",
-  "description": "AI Agent Terminal for Windows - Run Claude Code, Codex, Gemini CLI in parallel",
-  "main": ".vite/build/index.js",
-  "scripts": {
-    "start": "npm run build:mcp && electron-forge start",
-    "package": "npm run build:mcp && electron-forge package",
-    "make": "npm run build:mcp && electron-forge make",
-    "publish": "electron-forge publish",
-    "lint": "eslint --ext .ts,.tsx .",
-    "build:cli": "tsc -p tsconfig.cli.json",
-    "build:mcp": "tsc -p tsconfig.mcp.json",
-    "cli": "node dist/cli/cli/index.js",
-    "mcp": "node dist/mcp/mcp/index.js"
-  },
-  "bin": {
-    "wmux": "dist/cli/cli/index.js",
-    "wmux-mcp": "dist/mcp/mcp/index.js"
-  },
-  "keywords": ["terminal", "multiplexer", "electron", "ai", "claude", "agent", "windows", "pty", "mcp"],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/openwong2kim/wmux.git"
-  },
-  "author": {
-    "name": "openwong2kim",
-    "email": "100856670+openwong2kim@users.noreply.github.com"
-  },
-  "license": "MIT",
-  "files": [
-    "dist/cli",
-    "dist/mcp",
-    "src",
-    "assets",
-    "index.html",
-    "forge.config.ts",
-    "vite.*.config.ts",
-    "tsconfig*.json",
-    "tailwind.config.js",
-    "postcss.config.js"
-  ],
-  "devDependencies": {
-    "@electron-forge/cli": "^7.11.1",
-    "@electron-forge/maker-deb": "^7.11.1",
-    "@electron-forge/maker-rpm": "^7.11.1",
-    "@electron-forge/maker-squirrel": "^7.11.1",
-    "@electron-forge/maker-zip": "^7.11.1",
-    "@electron-forge/plugin-auto-unpack-natives": "^7.11.1",
-    "@electron-forge/plugin-fuses": "^7.11.1",
-    "@electron-forge/plugin-vite": "^7.11.1",
-    "@electron/fuses": "^1.8.0",
-    "@types/electron-squirrel-startup": "^1.0.2",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "@typescript-eslint/eslint-plugin": "^5.62.0",
-    "@typescript-eslint/parser": "^5.62.0",
-    "@vitejs/plugin-react": "^4.7.0",
-    "autoprefixer": "^10.4.27",
-    "electron": "41.0.3",
-    "eslint": "^8.57.1",
-    "eslint-plugin-import": "^2.32.0",
-    "postcss": "^8.5.8",
-    "tailwindcss": "^3.4.19",
-    "typescript": "^5.9.3",
-    "vite": "^5.4.21"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "@xterm/addon-fit": "^0.11.0",
-    "@xterm/addon-search": "^0.16.0",
-    "@xterm/addon-webgl": "^0.19.0",
-    "@xterm/xterm": "^6.0.0",
-    "electron-squirrel-startup": "^1.0.1",
-    "immer": "^11.1.4",
-    "node-pty": "^1.1.0",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4",
-    "react-resizable-panels": "^4.7.3",
-    "zod": "^4.3.6",
-    "zustand": "^5.0.12"
-  }
-}
+{
+  "name": "@wong2kim/wmux",
+  "productName": "wmux",
+  "version": "1.0.1",
+  "description": "Windows terminal multiplexer with MCP server for AI agents - run multiple CLI sessions in parallel, control via Claude Code and other AI tools",
+  "main": ".vite/build/index.js",
+  "scripts": {
+    "postinstall": "node scripts/fix-node-pty.js",
+    "start": "npm run build:mcp && electron-forge start",
+    "package": "npm run build:mcp && electron-forge package",
+    "make": "npm run build:mcp && electron-forge make",
+    "publish": "electron-forge publish",
+    "lint": "eslint --ext .ts,.tsx .",
+    "build:cli": "tsc -p tsconfig.cli.json",
+    "build:mcp": "tsc -p tsconfig.mcp.json",
+    "cli": "node dist/cli/cli/index.js",
+    "mcp": "node dist/mcp/mcp/index.js",
+    "prepublishOnly": "npm run build:cli && npm run build:mcp"
+  },
+  "bin": {
+    "wmux": "dist/cli/cli/index.js",
+    "wmux-mcp": "dist/mcp/mcp/index.js"
+  },
+  "files": [
+    "dist/cli/",
+    "dist/mcp/",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "terminal",
+    "multiplexer",
+    "mcp",
+    "ai-agent",
+    "cli",
+    "windows",
+    "claude-code",
+    "electron"
+  ],
+  "author": {
+    "name": "openwong2kim",
+    "email": "100856670+openwong2kim@users.noreply.github.com"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openwong2kim/wmux.git"
+  },
+  "homepage": "https://github.com/openwong2kim/wmux#readme",
+  "bugs": {
+    "url": "https://github.com/openwong2kim/wmux/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@electron-forge/cli": "^7.11.1",
+    "@electron-forge/maker-deb": "^7.11.1",
+    "@electron-forge/maker-rpm": "^7.11.1",
+    "@electron-forge/maker-squirrel": "^7.11.1",
+    "@electron-forge/maker-zip": "^7.11.1",
+    "@electron-forge/plugin-auto-unpack-natives": "^7.11.1",
+    "@electron-forge/plugin-fuses": "^7.11.1",
+    "@electron-forge/plugin-vite": "^7.11.1",
+    "@electron/fuses": "^1.8.0",
+    "@types/electron-squirrel-startup": "^1.0.2",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@typescript-eslint/eslint-plugin": "^5.62.0",
+    "@typescript-eslint/parser": "^5.62.0",
+    "@vitejs/plugin-react": "^4.7.0",
+    "autoprefixer": "^10.4.27",
+    "electron": "41.0.3",
+    "eslint": "^8.57.1",
+    "eslint-plugin-import": "^2.32.0",
+    "postcss": "^8.5.8",
+    "tailwindcss": "^3.4.19",
+    "typescript": "^5.9.3",
+    "vite": "^5.4.21"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/addon-search": "^0.16.0",
+    "@xterm/addon-webgl": "^0.19.0",
+    "@xterm/xterm": "^6.0.0",
+    "electron-squirrel-startup": "^1.0.1",
+    "immer": "^11.1.4",
+    "node-pty": "^1.1.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "react-resizable-panels": "^4.7.3",
+    "zod": "^4.3.6",
+    "zustand": "^5.0.12"
+  }
+}

package/assets/icon.svg

@@ -1,6 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="none">
-  <rect width="256" height="256" rx="48" fill="#1e1e2e"/>
-  <rect x="8" y="8" width="240" height="240" rx="40" fill="#181825" stroke="#313244" stroke-width="2"/>
-  <text x="128" y="170" text-anchor="middle" font-family="monospace" font-weight="bold" font-size="140" fill="#89b4fa">W</text>
-  <circle cx="200" cy="64" r="16" fill="#a6e3a1"/>
-</svg>

package/forge.config.ts

@@ -1,61 +0,0 @@
-import type { ForgeConfig } from '@electron-forge/shared-types';
-import { MakerSquirrel } from '@electron-forge/maker-squirrel';
-import { MakerZIP } from '@electron-forge/maker-zip';
-import { VitePlugin } from '@electron-forge/plugin-vite';
-import { AutoUnpackNativesPlugin } from '@electron-forge/plugin-auto-unpack-natives';
-import { FusesPlugin } from '@electron-forge/plugin-fuses';
-import { FuseV1Options, FuseVersion } from '@electron/fuses';
-
-const config: ForgeConfig = {
-  packagerConfig: {
-    asar: true,
-    icon: './assets/icon',
-    extraResource: ['./dist/mcp'],
-  },
-  rebuildConfig: { disablePreGypRecuild: true },
-  hooks: {
-    // Skip native rebuild — pre-built binaries already in node_modules
-    readPackageJson: async (_config, packageJson) => {
-      packageJson.dependencies = packageJson.dependencies || {};
-      return packageJson;
-    },
-  },
-  makers: [
-    new MakerSquirrel({}),
-    new MakerZIP({}, ['darwin']),
-  ],
-  plugins: [
-    new AutoUnpackNativesPlugin({}),
-    new VitePlugin({
-      build: [
-        {
-          entry: 'src/main/index.ts',
-          config: 'vite.main.config.ts',
-          target: 'main',
-        },
-        {
-          entry: 'src/preload/preload.ts',
-          config: 'vite.preload.config.ts',
-          target: 'preload',
-        },
-      ],
-      renderer: [
-        {
-          name: 'main_window',
-          config: 'vite.renderer.config.ts',
-        },
-      ],
-    }),
-    new FusesPlugin({
-      version: FuseVersion.V1,
-      [FuseV1Options.RunAsNode]: false,
-      [FuseV1Options.EnableCookieEncryption]: true,
-      [FuseV1Options.EnableNodeOptionsEnvironmentVariable]: false,
-      [FuseV1Options.EnableNodeCliInspectArguments]: false,
-      [FuseV1Options.EnableEmbeddedAsarIntegrityValidation]: true,
-      [FuseV1Options.OnlyLoadAppFromAsar]: true,
-    }),
-  ],
-};
-
-export default config;

package/index.html

@@ -1,12 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>WinMux</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/renderer/index.tsx"></script>
-  </body>
-</html>

package/postcss.config.js

@@ -1,6 +0,0 @@
-module.exports = {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-};

package/src/cli/client.ts

@@ -1,76 +0,0 @@
-#!/usr/bin/env node
-import * as net from 'net';
-import * as crypto from 'crypto';
-import type { RpcRequest, RpcResponse, RpcMethod } from '../shared/rpc';
-
-const PIPE_NAME = process.env.WMUX_SOCKET_PATH || '\\\\.\\pipe\\wmux';
-const TIMEOUT_MS = 5000;
-
-export function sendRequest(
-  method: RpcMethod,
-  params: Record<string, unknown> = {}
-): Promise<RpcResponse> {
-  return new Promise((resolve, reject) => {
-    const id = crypto.randomUUID();
-    const token = process.env.WMUX_AUTH_TOKEN;
-    const request: RpcRequest = { id, method, params, token };
-
-    const socket = net.connect(PIPE_NAME);
-    let buffer = '';
-    let settled = false;
-
-    const timer = setTimeout(() => {
-      if (!settled) {
-        settled = true;
-        socket.destroy();
-        reject(new Error('Request timed out after 5 seconds.'));
-      }
-    }, TIMEOUT_MS);
-
-    socket.on('connect', () => {
-      socket.write(JSON.stringify(request) + '\n');
-    });
-
-    socket.on('data', (chunk: Buffer) => {
-      buffer += chunk.toString('utf8');
-      const lines = buffer.split('\n');
-      buffer = lines.pop() ?? '';
-
-      for (const line of lines) {
-        const trimmed = line.trim();
-        if (!trimmed) continue;
-        try {
-          const response = JSON.parse(trimmed) as RpcResponse;
-          if (response.id === id && !settled) {
-            settled = true;
-            clearTimeout(timer);
-            socket.destroy();
-            resolve(response);
-          }
-        } catch {
-          // ignore malformed lines
-        }
-      }
-    });
-
-    socket.on('error', (err: NodeJS.ErrnoException) => {
-      if (!settled) {
-        settled = true;
-        clearTimeout(timer);
-        if (err.code === 'ENOENT' || err.code === 'ECONNREFUSED') {
-          reject(new Error('wmux is not running. Start the app first.'));
-        } else {
-          reject(new Error(`Connection error: ${err.message}`));
-        }
-      }
-    });
-
-    socket.on('close', () => {
-      if (!settled) {
-        settled = true;
-        clearTimeout(timer);
-        reject(new Error('Connection closed before response was received.'));
-      }
-    });
-  });
-}

package/src/cli/commands/browser.ts

@@ -1,128 +0,0 @@
-import { sendRequest } from '../client';
-import { printResult, printError } from '../utils';
-import type { RpcResponse } from '../../shared/rpc';
-
-const BROWSER_HELP = `
-wmux browser — Scriptable Browser API
-
-USAGE
-  wmux browser <subcommand> [args]
-
-SUBCOMMANDS
-  snapshot                        Return the full page HTML (document.documentElement.outerHTML)
-  click <selector>                Click the first element matching the CSS selector
-  fill <selector> <text>          Set the value of an input matching the CSS selector
-  eval <code>                     Execute arbitrary JavaScript in the page context
-  navigate <url>                  Navigate the active browser surface to a URL
-
-EXAMPLES
-  wmux browser snapshot
-  wmux browser click "#submit-btn"
-  wmux browser fill "input[name=email]" "user@example.com"
-  wmux browser eval "document.title"
-  wmux browser navigate "https://example.com"
-`.trimStart();
-
-export async function handleBrowser(
-  args: string[],
-  jsonMode: boolean,
-): Promise<void> {
-  const sub = args[0];
-  const rest = args.slice(1);
-
-  if (!sub || sub === '--help' || sub === '-h') {
-    process.stdout.write(BROWSER_HELP);
-    process.exit(0);
-  }
-
-  let response: RpcResponse;
-
-  switch (sub) {
-    // ── browser snapshot ─────────────────────────────────────────────────────
-    case 'snapshot': {
-      response = await sendRequest('browser.snapshot', {});
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        const r = response.result as { html?: string } | null;
-        process.stdout.write(r?.html ?? '');
-      }
-      break;
-    }
-
-    // ── browser click <selector> ─────────────────────────────────────────────
-    case 'click': {
-      const selector = rest[0];
-      if (!selector) {
-        console.error('Error: browser click requires <selector>');
-        process.exit(1);
-      }
-      response = await sendRequest('browser.click', { selector });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        console.log(`Clicked: ${selector}`);
-      }
-      break;
-    }
-
-    // ── browser fill <selector> <text> ───────────────────────────────────────
-    case 'fill': {
-      const selector = rest[0];
-      const text = rest.slice(1).join(' ');
-      if (!selector) {
-        console.error('Error: browser fill requires <selector> <text>');
-        process.exit(1);
-      }
-      response = await sendRequest('browser.fill', { selector, text });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        console.log(`Filled "${selector}" with "${text}"`);
-      }
-      break;
-    }
-
-    // ── browser eval <code> ──────────────────────────────────────────────────
-    case 'eval': {
-      const code = rest.join(' ');
-      if (!code) {
-        console.error('Error: browser eval requires <code>');
-        process.exit(1);
-      }
-      response = await sendRequest('browser.eval', { code });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        const r = response.result as { result?: unknown } | null;
-        console.log(JSON.stringify(r?.result, null, 2));
-      }
-      break;
-    }
-
-    // ── browser navigate <url> ───────────────────────────────────────────────
-    case 'navigate': {
-      const url = rest[0];
-      if (!url) {
-        console.error('Error: browser navigate requires <url>');
-        process.exit(1);
-      }
-      response = await sendRequest('browser.navigate', { url });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        console.log(`Navigated to: ${url}`);
-      }
-      break;
-    }
-
-    default:
-      console.error(`Unknown browser subcommand: "${sub}". Run 'wmux browser --help' for usage.`);
-      process.exit(1);
-  }
-}

package/src/cli/commands/input.ts

@@ -1,72 +0,0 @@
-import { sendRequest } from '../client';
-import { printResult, printError } from '../utils';
-import type { RpcResponse } from '../../shared/rpc';
-
-export async function handleInput(
-  cmd: string,
-  args: string[],
-  jsonMode: boolean
-): Promise<void> {
-  let response: RpcResponse;
-
-  switch (cmd) {
-    case 'send': {
-      const text = args.join(' ');
-      if (!text) {
-        console.error('Error: send requires <text>');
-        process.exit(1);
-      }
-      response = await sendRequest('input.send', { text });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        console.log('Text sent.');
-      }
-      break;
-    }
-
-    case 'send-key': {
-      const key = args[0];
-      if (!key) {
-        console.error('Error: send-key requires <keystroke>');
-        process.exit(1);
-      }
-      response = await sendRequest('input.sendKey', { key });
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        console.log(`Key sent: ${key}`);
-      }
-      break;
-    }
-
-    case 'read-screen': {
-      response = await sendRequest('input.readScreen', {});
-      if (jsonMode) {
-        printResult(response);
-      } else {
-        if (!response.ok) { printError(response); return; }
-        // server returns { text: string } object or plain string
-        const result = response.result as { text?: string } | string;
-        let screen: string;
-        if (typeof result === 'object' && result !== null && 'text' in result) {
-          screen = result.text ?? '';
-        } else if (typeof result === 'string') {
-          screen = result;
-        } else {
-          console.log(JSON.stringify(result, null, 2));
-          break;
-        }
-        process.stdout.write(screen);
-        if (!screen.endsWith('\n')) process.stdout.write('\n');
-      }
-      break;
-    }
-
-    default:
-      console.error(`Unknown input command: ${cmd}`);
-      process.exit(1);
-  }
-}

package/src/cli/commands/notify.ts

@@ -1,29 +0,0 @@
-import { sendRequest } from '../client';
-import { printResult, printError, parseFlag } from '../utils';
-import type { RpcResponse } from '../../shared/rpc';
-
-export async function handleNotify(
-  args: string[],
-  jsonMode: boolean
-): Promise<void> {
-  const title = parseFlag(args, '--title');
-  const body = parseFlag(args, '--body');
-
-  if (!title) {
-    console.error('Error: notify requires --title <text>');
-    process.exit(1);
-  }
-  if (!body) {
-    console.error('Error: notify requires --body <text>');
-    process.exit(1);
-  }
-
-  const response: RpcResponse = await sendRequest('notify', { title, body });
-
-  if (jsonMode) {
-    printResult(response);
-  } else {
-    if (!response.ok) { printError(response); return; }
-    console.log(`Notification sent: "${title}"`);
-  }
-}