wisp-agents 0.24.0 → 0.24.1

package/CHANGELOG.md

@@ -5,6 +5,12 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 
 ## [Unreleased]
 
+## [0.24.1] - 2026-10-20
+
+### Fixed
+
+- **Update now updates, however you installed wisp.** **Update to X** installs the new version and restarts wisp for every install route: `npx`, `npm install -g`, the `install.sh` script, and now Homebrew. On a Homebrew install it used to run `npm install -g` and then restart the old keg. Now it runs `brew upgrade m0xoo/tap/wisp-agents` and restarts from the new keg. If the install leaves wisp on the same version (the tap doesn't have the release yet, or npm installed into a different folder), the button says so instead of restarting into the old version and then reporting that wisp didn't come back. A git clone of the repo no longer shows the button or tells you to run `git pull`. `GET /update` no longer returns `auto`, and the method can now be `brew`.
+
 ## [0.24.0] - 2026-10-20
 
 ### Added
@@ -436,7 +442,8 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 - Session queue with follow-ups, answers to agent questions, terminal takeover and mark-as-done.
 - Older turns are folded, with a floating collapse-all button and back-to-top.
 
-[Unreleased]: https://github.com/M0xoo/wisp/compare/v0.24.0...HEAD
+[Unreleased]: https://github.com/M0xoo/wisp/compare/v0.24.1...HEAD
+[0.24.1]: https://github.com/M0xoo/wisp/compare/v0.24.0...v0.24.1
 [0.24.0]: https://github.com/M0xoo/wisp/compare/v0.23.0...v0.24.0
 [0.23.0]: https://github.com/M0xoo/wisp/compare/v0.22.0...v0.23.0
 [0.22.0]: https://github.com/M0xoo/wisp/compare/v0.21.0...v0.22.0

package/README.md

@@ -56,7 +56,7 @@ From there you can **follow up**, **answer its questions**, **take it over** in
 | 🤝 **Subagents** | Give the lead agent a team on other harnesses (e.g. Claude Code hands tests to Codex ×3). It delegates through a `delegate` tool; their edits land in its worktree. See [Subagents](#subagents). |
 | ⏪ **Checkpoints & rollback** | Every turn is snapshotted first. Restore to before any turn, revert a single file, or re-run a command block from the presentation. |
 | ⚖️ **Compare** | Run one task on two harnesses side by side, and keep the better run. |
-| 🧾 **Recipes & triggers** | Saved prompts with `{params}` (`wisp run release 0.24.0`), run by hand, on a schedule, when CI fails, or when an issue is labelled. |
+| 🧾 **Recipes & triggers** | Saved prompts with `{params}` (`wisp run release 0.24.1`), run by hand, on a schedule, when CI fails, or when an issue is labelled. |
 | 📊 **Usage** | Spend, success rate and questions per project and per harness · model. |
 | 📱 **Phone** | Questions and finished tasks on ntfy or Telegram; answer from there, or start a task with `/new`. |
 | 🔐 **Permission modes** | Choose **Plan** (read-only), **Edits** (file edits auto-accepted), or **Full auto** (no permission prompts, the default) for each launch. `Shift+Tab` in the prompt cycles modes. In Edits mode, anything the permissions block comes to you: Claude Code waits for **Allow / Always / Deny**, and the other harnesses show an **Allow & retry** card. |
@@ -85,7 +85,7 @@ brew install m0xoo/tap/wisp-agents             # Homebrew: CLI and browser mode,
 wisp "fix the flaky auth test"
 ```
 
-The Homebrew formula lives in [M0xoo/homebrew-tap](https://github.com/M0xoo/homebrew-tap). `install.sh` honors `WISP_VERSION` to pin a release (`curl -fsSL https://trywisp.dev/install.sh | WISP_VERSION=0.24.0 bash`).
+The Homebrew formula lives in [M0xoo/homebrew-tap](https://github.com/M0xoo/homebrew-tap). `install.sh` honors `WISP_VERSION` to pin a release (`curl -fsSL https://trywisp.dev/install.sh | WISP_VERSION=0.24.1 bash`).
 
 From source:
 
@@ -135,7 +135,7 @@ wisp btw <id> "did you do X?"     # ask on the side without interrupting the run
 wisp stop <id>
 wisp ship <id> [--draft]          # commit, push and open a PR for a worktree task
 wisp merge <id>                   # squash-merge its PR, fast-forward your local main
-wisp run release 0.24.0            # run a recipe; values fill its {params} (or version=0.24.0)
+wisp run release 0.24.1            # run a recipe; values fill its {params} (or version=0.24.1)
 wisp recipes                      # list recipes
 wisp usage [--days 7]             # spend and outcomes
 wisp mcp                          # MCP server for other agents and editors
@@ -354,7 +354,7 @@ Before each turn, wisp snapshots the git working tree (pinned at `refs/wisp/chec
 Prepare release {version}: update CHANGELOG, README and docs/, bump package.json, tag v{version}.
 ```
 
-Make one from ⌘K → *Recipes*, or *Save as recipe…* on any card. A recipe may pin a project, harness, model and mode. Run it from ⌘K (*Run: Release*), from the Recipes view, or from a terminal: `wisp run release 0.24.0` fills the fields in order, `wisp run release version=0.24.0` by name.
+Make one from ⌘K → *Recipes*, or *Save as recipe…* on any card. A recipe may pin a project, harness, model and mode. Run it from ⌘K (*Run: Release*), from the Recipes view, or from a terminal: `wisp run release 0.24.1` fills the fields in order, `wisp run release version=0.24.1` by name.
 
 **Triggers** launch sessions on their own while wisp is open (⌘K → *Triggers*):
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wisp-agents",
-  "version": "0.24.0",
+  "version": "0.24.1",
   "description": "Run Claude Code, Codex, Cursor and other coding agents in parallel, in the background, on any of your machines. Skip the transcript, read the report.",
   "type": "module",
   "bin": {

package/server/openapi.js

@@ -25,7 +25,7 @@ export function openapi({ version, port }) {
     paths: {
       '/health': { get: { summary: 'Liveness, version and pid', responses: { 200: json(ref('Health')) } } },
       '/update': {
-        get: { summary: 'Current and latest published version, and how this copy updates (global | npx | git). ?check forces a registry check', responses: { 200: json({ type: 'object' }) } },
+        get: { summary: 'Current and latest published version, and how this copy updates (global | npx | brew | git; a git clone never offers one). ?check forces a registry check', responses: { 200: json({ type: 'object' }) } },
         post: { summary: 'Install the latest version and relaunch. 409 while agents run unless { force: true }', responses: { 202: json({ type: 'object' }), 409: json({ type: 'object' }) } },
       },
       '/preferences': {

package/server/update.js

@@ -1,8 +1,9 @@
 // Update check: polls the npm registry for a newer wisp-agents and, when asked, installs it and
 // relaunches wisp. How depends on how this copy was installed:
-//   global  npm install -g wisp-agents@latest, then rerun bin/wisp.js from the same folder
+//   global  npm install -g wisp-agents@latest (also what install.sh does), then rerun bin/wisp.js
 //   npx     nothing to install: relaunch through `npx -y wisp-agents@latest`
-//   git     a clone: we only tell you to pull
+//   brew    brew upgrade m0xoo/tap/wisp-agents, then rerun it from the keg's opt/ link
+//   git     a clone of the repo, i.e. working on wisp itself: never offers an update
 // Opt out with WISP_UPDATE_CHECK=0.
 
 import { spawn } from 'node:child_process';
@@ -16,6 +17,9 @@ const PKG = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8'))
 const REGISTRY = `https://registry.npmjs.org/${PKG.name}/latest`;
 const DAY = 24 * 3600_000;
 const TICK = 30 * 60_000; // timers stall while the machine sleeps, so poll the wall clock instead
+const TAP = 'm0xoo/tap/wisp-agents';
+// <prefix>/Cellar/wisp-agents/<version>/libexec/lib/node_modules/wisp-agents
+const CELLAR = /^(.*)[\\/]Cellar[\\/]wisp-agents[\\/]/;
 
 export function newer(a, b) {
   const p = (v) => String(v).replace(/^v/, '').split(/[-+]/)[0].split('.').map(Number);
@@ -25,20 +29,23 @@ export function newer(a, b) {
 }
 
 export function installMethod(root = ROOT) {
+  if (CELLAR.test(root)) return 'brew';
   if (fs.existsSync(path.join(root, '.git'))) return 'git';
   if (/[\\/]_npx[\\/]/.test(root)) return 'npx';
   return 'global';
 }
 
 export class Updater {
-  constructor({ port, onChange = () => {}, env = process.env, fetch = globalThis.fetch, now = Date.now } = {}) {
+  constructor({ port, onChange = () => {}, env = process.env, fetch = globalThis.fetch, now = Date.now, root = ROOT } = {}) {
     this.port = port;
     this.onChange = onChange;
     this.fetch = fetch;
     this.now = now;
     this.checkedAt = -Infinity;
-    this.enabled = !/^(0|false|no|off)$/i.test(env.WISP_UPDATE_CHECK || '') && !env.CI;
-    this.method = installMethod();
+    this.root = root;
+    this.method = installMethod(root);
+    this.brew = root.match(CELLAR)?.[1]; // Homebrew's prefix, e.g. /opt/homebrew
+    this.enabled = this.method !== 'git' && !/^(0|false|no|off)$/i.test(env.WISP_UPDATE_CHECK || '') && !env.CI;
     this.state = { current: PKG.version, latest: null, available: false, method: this.method, status: 'idle', error: null };
   }
 
@@ -60,9 +67,20 @@ export class Updater {
   }
 
   view() {
-    const s = this.state;
-    const command = { global: `npm install -g ${PKG.name}@latest`, npx: `npx -y ${PKG.name}@latest`, git: 'git pull' }[s.method];
-    return { ...s, command, auto: s.method !== 'git' };
+    return { ...this.state, command: this.command() };
+  }
+
+  // What installs the latest version; shown to copy if it fails. A clone has none.
+  command() {
+    if (this.method === 'brew') return `${JSON.stringify(path.join(this.brew, 'bin', 'brew'))} upgrade ${TAP}`;
+    return { global: `npm install -g ${PKG.name}@latest`, npx: `npx -y ${PKG.name}@latest` }[this.method];
+  }
+
+  // Where the updated copy lives: the same folder, except Homebrew puts each version in its own
+  // keg and keeps opt/wisp-agents pointing at the current one.
+  home() {
+    if (this.method !== 'brew') return this.root;
+    return path.join(this.brew, 'opt', 'wisp-agents', 'libexec', 'lib', 'node_modules', PKG.name);
   }
 
   async check() {
@@ -71,20 +89,28 @@ export class Updater {
       const r = await this.fetch(REGISTRY, { headers: { accept: 'application/json' }, signal: AbortSignal.timeout(10_000) });
       if (!r.ok) return this.view();
       const { version } = await r.json();
-      const available = newer(version, PKG.version);
+      const available = this.method !== 'git' && newer(version, PKG.version);
       if (version !== this.state.latest || available !== this.state.available) this.set({ latest: version, available });
     } catch {} // offline: try again next round
     return this.view();
   }
 
-  // Installs (global) then hands off to a detached helper that waits for this server's port to
-  // free up and starts the new version. The caller shuts this process down.
+  // Installs (npm or brew; npx fetches on relaunch) then hands off to a detached helper that waits
+  // for this server's port to free up and starts the new version. The caller shuts this process down.
   async install() {
-    if (this.method === 'git') throw bad('This is a git checkout: run `git pull` to update.');
+    if (this.method === 'git') throw bad('This copy of wisp is a git clone, so it does not update itself.');
     if (this.state.status === 'installing') throw bad('Already updating.', 409);
     this.set({ status: 'installing', error: null });
     try {
-      if (this.method === 'global') await run(`npm install -g ${PKG.name}@latest`);
+      if (this.method !== 'npx') {
+        // Old kegs stay until brew's own periodic cleanup: this process still runs from one.
+        await run(this.command(), this.method === 'brew' ? { HOMEBREW_NO_INSTALL_CLEANUP: '1' } : {});
+        // Relaunching a copy that didn't change would leave the UI waiting for a version that never comes.
+        const got = installedVersion(this.home());
+        if (!newer(got, PKG.version)) {
+          throw bad(this.method === 'brew' ? `Homebrew doesn't have wisp ${this.state.latest} yet. Try again later.` : `npm installed wisp somewhere else: this copy is still ${got || PKG.version}.`);
+        }
+      }
     } catch (err) {
       this.set({ status: 'idle', error: err.message });
       throw err;
@@ -97,13 +123,21 @@ export class Updater {
   relaunchCommand(electron = !!process.versions.electron) {
     const args = `${electron ? '' : ' --browser --no-open'} --port ${this.port}`; // desktop: reopen the app; browser: keep the tab
     const node = JSON.stringify(electron ? 'node' : process.execPath);
-    return this.method === 'npx' ? `npx -y ${PKG.name}@latest${args}` : `${node} ${JSON.stringify(path.join(ROOT, 'bin', 'wisp.js'))}${args}`;
+    return this.method === 'npx' ? `npx -y ${PKG.name}@latest${args}` : `${node} ${JSON.stringify(path.join(this.home(), 'bin', 'wisp.js'))}${args}`;
+  }
+}
+
+function installedVersion(dir) {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf8')).version;
+  } catch {
+    return null;
   }
 }
 
-function run(cmd) {
+function run(cmd, env = {}) {
   return new Promise((resolve, reject) => {
-    const child = spawn(cmd, { shell: true, stdio: ['ignore', 'ignore', 'pipe'], env: withoutElectronNode() });
+    const child = spawn(cmd, { shell: true, stdio: ['ignore', 'ignore', 'pipe'], env: { ...withoutElectronNode(), ...env } });
     let err = '';
     child.stderr.on('data', (d) => (err = (err + d).slice(-2000)));
     child.on('error', reject);

package/web/js/features/update.js

@@ -18,12 +18,11 @@ export function renderUpdate(u) {
   b.disabled = busy;
   b.classList.toggle('busy', busy);
   b.querySelector('span').textContent = u.status === 'installing' ? 'Updating…' : u.status === 'restarting' ? 'Restarting…' : `Update to ${u.latest}`;
-  b.title = u.auto ? `wisp ${u.current} → ${u.latest}: install and restart` : `wisp ${u.latest} is out. Run \`${u.command}\` to update`;
+  b.title = `wisp ${u.current} → ${u.latest}: install and restart`;
 }
 
 export async function installUpdate() {
   if (!update?.available) return;
-  if (!update.auto) return toast(`wisp <b>${esc(update.latest)}</b> is out. Run <code>${esc(update.command)}</code>`, { action: { label: 'Copy', run: () => copy(update.command) }, timeout: 8000 });
   const post = (force) => api('/update', { method: 'POST', body: { force } });
   try {
     await post(false).catch(async (err) => {