phewsh 0.12.0 → 0.12.2

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
 
@@ -67,6 +67,7 @@ phewsh pull               # Sync cloud to local
 phewsh mcp setup          # Configure MCP server for agent connectivity
 phewsh mcp serve          # Coordination bridge — route work to live agents
 phewsh receipts           # Proof trail — what agents actually did, with evidence
+phewsh update             # Update phewsh to the latest version
 phewsh style              # Build your style identity
 ```
 

package/bin/phewsh.js

@@ -64,6 +64,7 @@ const COMMANDS = {
   watch:   () => require('../commands/watch')(),
   mcp:     () => require('../commands/mcp')(),
   receipts: () => require('../commands/receipts')(),
+  update:  () => require('../commands/update')(),
   serve:   () => require('../commands/serve')(),
   sequence: () => require('../commands/sequence')(),
   seq:     () => require('../commands/sequence')(),
@@ -103,6 +104,7 @@ function showHelp() {
   console.log(`  ${b(w('configure'))}`);
   console.log(`    ${cyan('login')}      ${g('Identity + API key + cloud sync')}`);
   console.log(`    ${cyan('link')}       ${g('Link local .intent/ to cloud project')}`);
+  console.log(`    ${cyan('update')}     ${g('Update phewsh to the latest version')}`);
   console.log('');
   console.log(`  ${g('Works in: Claude Code · Cursor · ChatGPT · any MCP agent')}`);
   console.log(`  ${g('No account needed. Account adds sync + sharing.')}`);
@@ -127,7 +129,7 @@ function checkForUpdates() {
           newer[2] > current[2];
         if (isNewer) {
           console.log(g(`\n  Update available: ${pkg.version} → ${data.version}`));
-          console.log(g(`  Run: npm install -g phewsh\n`));
+          console.log(g(`  Run: phewsh update\n`));
         }
       }
     })

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/commands/update.js

@@ -0,0 +1,79 @@
+// phewsh update — update the CLI to the latest published version.
+//
+// Usage:
+//   phewsh update           Check npm and install the latest version
+//   phewsh update --check   Just compare versions, don't install
+
+const { spawn } = require('child_process');
+
+const b = (s) => `\x1b[1m${s}\x1b[0m`;
+const w = (s) => `\x1b[97m${s}\x1b[0m`;
+const g = (s) => `\x1b[38;2;130;142;138m${s}\x1b[0m`;
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+
+function isNewer(latest, current) {
+  const l = latest.split('.').map(Number);
+  const c = current.split('.').map(Number);
+  return l[0] !== c[0] ? l[0] > c[0] : l[1] !== c[1] ? l[1] > c[1] : l[2] > c[2];
+}
+
+async function main() {
+  const checkOnly = process.argv.includes('--check');
+  const pkg = require('../package.json');
+
+  console.log('');
+  console.log(`  ${b(w('phewsh update'))}`);
+  console.log('');
+  console.log(`  ${g('current:')} v${pkg.version}`);
+
+  let latest;
+  try {
+    const res = await fetch(`https://registry.npmjs.org/${pkg.name}/latest`, {
+      signal: AbortSignal.timeout(5000),
+    });
+    latest = (await res.json()).version;
+  } catch {
+    console.log(`  ${yellow('Could not reach the npm registry. Try again later.')}`);
+    console.log('');
+    return;
+  }
+  console.log(`  ${g('latest: ')} v${latest}`);
+  console.log('');
+
+  if (!latest || !isNewer(latest, pkg.version)) {
+    console.log(`  ${green('Already up to date.')}`);
+    console.log('');
+    return;
+  }
+
+  if (checkOnly) {
+    console.log(`  ${w(`v${latest} available.`)} Run ${w('phewsh update')} to install.`);
+    console.log('');
+    return;
+  }
+
+  console.log(`  ${g('Installing')} ${w(`phewsh@${latest}`)} ${g('via npm…')}`);
+  console.log('');
+
+  const child = spawn('npm', ['install', '-g', `${pkg.name}@latest`], { stdio: 'inherit' });
+  child.on('close', (code) => {
+    console.log('');
+    if (code === 0) {
+      console.log(`  ${green('✓')} Updated to v${latest}. New shells pick it up immediately.`);
+    } else {
+      console.log(`  ${yellow('Update failed')} (npm exited ${code}).`);
+      console.log(`  ${g('If it was a permissions error, fix your npm prefix or run:')}`);
+      console.log(`  ${w(`sudo npm install -g ${pkg.name}@latest`)}`);
+    }
+    console.log('');
+    process.exit(code ?? 0);
+  });
+  child.on('error', (err) => {
+    console.log(`  ${yellow('Could not run npm:')} ${err.message}`);
+    console.log('');
+    process.exit(1);
+  });
+}
+
+module.exports = main;

package/package.json

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