phewsh 0.12.0 → 0.12.1

package/README.md

@@ -23,7 +23,7 @@ Connect the web app to your local machine for real-time task execution:
 phewsh serve
 ```
 
-This starts a bridge on `localhost:7483`. Open [phewsh.com/intent](https://phewsh.com/intent) and go to the Work tab — you'll see a green "Live" indicator. Agent tasks get a "Run Live" button that executes via Claude Code on your machine.
+This starts a bridge on `localhost:7483`. Open [phewsh.com/intent](https://phewsh.com/intent) and go to the Work tab — you'll see a green "Live" indicator. Agent tasks get a "Run Live" button that executes on your machine through whichever agent CLIs you have installed: **Claude Code, Codex, Gemini, Cursor Agent, OpenCode**. PHEWSH detects them automatically and every run leaves a receipt (`phewsh receipts`).
 
 ## Interactive Shell
 

package/commands/serve.js

@@ -1,7 +1,11 @@
 // phewsh serve — HTTP bridge server for live execution from the web UI
 //
-// Starts a local server that the PHEWSH web app connects to for live task execution.
-// When running, the web UI shows a green "Live" indicator and "Run Live" buttons.
+// Starts a local server that the PHEWSH web app connects to for live task
+// execution. When running, the web UI shows a green "Live" indicator and
+// "Run Live" buttons for every agent CLI installed on this machine —
+// Claude Code, Codex, Gemini, Cursor Agent, OpenCode. PHEWSH is not a
+// harness; it dispatches to the harnesses you already have, and every run
+// leaves a receipt (~/.phewsh/ — see `phewsh receipts`).
 //
 // Usage:
 //   phewsh serve              Start on default port (7483)
@@ -31,15 +35,27 @@ function getPort() {
 
 // ─── Runtime Detection ─────────────────────────────────────────────────────
 
+// Harness runners — how to invoke each agent CLI headlessly. PHEWSH is not a
+// harness; it's the layer that dispatches to whichever harnesses you have.
+// Detection is honest: a runtime is only "connected" if its binary is on PATH.
+const RUNNERS = {
+  'claude-code': { bin: 'claude',       label: 'Claude Code',  args: (p) => ['-p', p, '--output-format', 'text'] },
+  'codex':       { bin: 'codex',        label: 'Codex CLI',    args: (p) => ['exec', p] },
+  'gemini':      { bin: 'gemini',       label: 'Gemini CLI',   args: (p) => ['-p', p] },
+  'cursor':      { bin: 'cursor-agent', label: 'Cursor Agent', args: (p) => ['-p', p, '--output-format', 'text'] },
+  'opencode':    { bin: 'opencode',     label: 'OpenCode',     args: (p) => ['run', p] },
+};
+
 function detectRuntimes() {
   const runtimes = [];
 
-  // Check for Claude Code CLI
-  try {
-    execSync('which claude', { stdio: 'pipe' });
-    runtimes.push({ id: 'claude-code', label: 'Claude Code', connected: true });
-  } catch {
-    runtimes.push({ id: 'claude-code', label: 'Claude Code', connected: false });
+  for (const [id, r] of Object.entries(RUNNERS)) {
+    let connected = false;
+    try {
+      execSync(`which ${r.bin}`, { stdio: 'pipe' });
+      connected = true;
+    } catch { /* not installed */ }
+    runtimes.push({ id, label: r.label, connected });
   }
 
   // Always report human as available
@@ -87,8 +103,9 @@ async function executeJob(jobId) {
 
   const { runtimeId, packet } = job;
 
-  if (runtimeId === 'claude-code') {
-    await executeViaClaude(job, packet);
+  const runner = RUNNERS[runtimeId];
+  if (runner) {
+    await executeViaHarness(job, packet, runner);
   } else {
     job.status = 'error';
     job.error = `Runtime ${runtimeId} not supported for live execution yet`;
@@ -96,7 +113,7 @@ async function executeJob(jobId) {
   }
 }
 
-async function executeViaClaude(job, packet) {
+async function executeViaHarness(job, packet, runner) {
   // Build a prompt from the dispatch packet
   const prompt = [
     `# Task: ${packet.objective?.task || 'Execute task'}`,
@@ -115,15 +132,17 @@ async function executeViaClaude(job, packet) {
   ].filter(Boolean).join('\n');
 
   return new Promise((resolve) => {
-    job.statusText = 'Launching Claude Code...';
+    job.statusText = `Launching ${runner.label}...`;
 
-    // Use claude CLI with --print flag for non-interactive output
-    const child = spawn('claude', ['-p', prompt, '--output-format', 'text'], {
+    const child = spawn(runner.bin, runner.args(prompt), {
       stdio: ['pipe', 'pipe', 'pipe'],
       env: { ...process.env },
       cwd: process.cwd(),
     });
 
+    // Some harnesses (codex exec, gemini) wait for stdin EOF before running.
+    child.stdin.end();
+
     let stdout = '';
     let stderr = '';
 
@@ -149,7 +168,7 @@ async function executeViaClaude(job, packet) {
         console.log(`  ${green('✓')} Job ${job.jobId.slice(0, 8)} completed`);
       } else {
         job.status = 'error';
-        job.error = stderr.trim() || `Claude exited with code ${code}`;
+        job.error = stderr.trim() || `${runner.label} exited with code ${code}`;
         job.statusText = 'Failed';
         console.log(`  ${yellow('✗')} Job ${job.jobId.slice(0, 8)} failed: ${job.error.slice(0, 100)}`);
       }
@@ -160,11 +179,11 @@ async function executeViaClaude(job, packet) {
         taskId: packet?.id || job.actionId || job.jobId,
         result: success ? job.result : job.error,
         success,
-        agentId: 'claude-code',
+        agentId: job.runtimeId,
         executor: 'phewsh-serve',
         reportedAt: new Date().toISOString(),
       });
-      recordSessionEvent('claude-code', 'web', 'task_complete', {
+      recordSessionEvent(job.runtimeId, 'web', 'task_complete', {
         taskId: packet?.id || job.actionId || job.jobId,
         success,
         result: (success ? job.result : job.error || '').slice(0, 200),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phewsh",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "Turn intent into action. Structure your thinking, execute your next step.",
   "bin": {
     "phewsh": "bin/phewsh.js"