From 423919440fb87fc29e3962b34720c31225fd0a52 Mon Sep 17 00:00:00 2001 From: nubbymong <192402368+nubbymong@users.noreply.github.com> Date: Wed, 18 Nov 2026 12:57:11 +0000 Subject: [PATCH 1/6] build(release): 2.1.3-beta.8 Version 2.1.3-beta.8 in package.json and package-lock.json, the 2.1.3-beta.8 What's New entry and CHANGELOG.md, and the user-facing surface sweep for the beta.8 PRs (#710 to #719): - app-knowledge: an update with Save keeps held terminals on Windows (Machines section), held Claude Code sessions send their hooks through the helper while the agent sessions setting is on (off by default), and a known issue with its workaround for the two minutes that run through the installer's pages. - tips: a Windows tip for Save at an update. - Feature Guide cards: Machines, Settings and Combined Mode. - README: the Machines bullet. - Pins for all of the above in app-knowledge.test.ts. - The P16 fragment's paragraph tail rewrapped (no wording change). Co-Authored-By: Claude Opus 5.5 --- CHANGELOG.md | 24 +++++ .../2026-11-17-probe-p16-hook-process-cost.md | 25 +++-- README.md | 2 +- package-lock.json | 4 +- package.json | 2 +- src/renderer/changelog.ts | 20 ++++ src/renderer/tips-library.ts | 18 ++++ src/renderer/training-steps.ts | 5 +- src/shared/app-knowledge.ts | 8 +- tests/unit/shared/app-knowledge.test.ts | 96 +++++++++++++++++++ 10 files changed, 182 insertions(+), 22 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index cafa24057..1a3cecc36 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 > `src/renderer/changelog.ts`. After editing that file, run `npm run changelog` > (CI enforces that this file is in sync via `npm run changelog:check`). +## [2.1.3-beta.8] - 2026-11-18 + +### Warnings +- This beta series begins moving the app's background services, and over the next betas your sessions, onto one helper per machine. If you want a quiet build, stay on the stable release. +- On Windows, the update to this version still ends the terminals the session helper holds, as before, because the version you update from decides what an update does. From this version on, choosing Save at an update keeps them running, if the new version opens within two minutes of the old one closing. The installer's pages count toward those two minutes, so finish the installer promptly. +- To go back to 2.1.3-beta.7, download its installer from the GitHub releases page and run it over this version. + +> On Windows, an app update can now keep the terminals the session helper holds running: choose Save, and the new version shows them again. The session helper no longer needs the Visual C++ runtime on Windows, a Codex review runs on your reviewer account's default Codex model, and the vision browser is closed on every way the app exits. + +### Added +- On Windows, with Plain terminals through the session helper on, choosing Save on the update dialog now keeps the terminals the helper holds running through an app update. The new version shows each Terminal only tab and partner terminal again in its tab, with what it printed meanwhile. A held terminal that no tab shows, such as one a crash left, keeps running too, and the Machines page lists it again. Close sessions ends them, as before. The new version must open within two minutes of the old one closing. On macOS and Linux an update still ends them, and Claude Code and Codex sessions still resume their conversation instead. + +### Changed +- With Claude Code and Codex sessions through the session helper on (a preview, off by default) and the HTTP Hooks Gateway on, a Claude Code session the helper holds now sends its hook events to the app through the session helper. The check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway. The attention dot, the hooks feed, the Watchdog and canvas notes work as before, and Codex sessions are unchanged. +- The session helper no longer wakes about 40 times a second for each terminal it holds, to check whether the program in it has ended. It now waits for that program to end instead. +- Codex reviews, Sentinel's analysis on Codex and Codex Insights reports now also run with three more Codex agent features switched off (multi_agent_v2, sleep_tool and the agents setting), which these runs do not need. + +### Fixed +- On Windows, the session helper no longer needs Microsoft's Visual C++ runtime. Before, on a PC without it the helper could not start, and the app ran without it. +- A Codex review now runs on your reviewer account's default Codex model, at the same medium reasoning effort. Before, it always asked for GPT-5.5, which OpenAI retired from Codex with ChatGPT sign-in on October 14, 2026. +- On Windows, the vision browser no longer keeps the app's files open after the app ends. +- The vision browser is now closed on every way the app exits, including an update install. + ## [2.1.3-beta.7] - 2026-11-17 ### Warnings @@ -2002,6 +2025,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Tab attention indicators for waiting prompts - Context usage tracking via statusline API +[2.1.3-beta.8]: https://github.com/nubbymong/ai-code-conductor/releases/tag/v2.1.3-beta.8 [2.1.3-beta.7]: https://github.com/nubbymong/ai-code-conductor/releases/tag/v2.1.3-beta.7 [2.1.3-beta.6]: https://github.com/nubbymong/ai-code-conductor/releases/tag/v2.1.3-beta.6 [2.1.3-beta.5]: https://github.com/nubbymong/ai-code-conductor/releases/tag/v2.1.3-beta.5 diff --git a/CONTEXT.d/2026-11-17-probe-p16-hook-process-cost.md b/CONTEXT.d/2026-11-17-probe-p16-hook-process-cost.md index f1c2de1a9..eb2c24e37 100644 --- a/CONTEXT.d/2026-11-17-probe-p16-hook-process-cost.md +++ b/CONTEXT.d/2026-11-17-probe-p16-hook-process-cost.md @@ -68,19 +68,18 @@ raised by the orchestrator. The whole-machine figure comes from the script's arithmetic over idle-cycle readings that were not recorded, so it cannot be recomputed from posted data; the total that can be (chain 29.11 + Defender 20.10 + starter 0.69 + holder 0.14) is 50.04 ms. Run 6's "chain plus -Defender, about 50 ms" left -out the starting program, the holder, csrss and the kernel. Reference: -today's HTTP hook POST, taken as the gateway takes it (a new connection each -time, the token checked, the body parsed), took 1.02 ms mean, 1.34 ms p95, -and 1.5 ms of CPU, client and server, against a baseline on the same -150-second schedule (runs 8 and 9: 1.02 and 1.03 ms, 1.5 and 1.6 ms). Run -7's 0.70 ms and 1.0 ms reused one connection and skipped the token check and -the parse, and run 6's 1.1 ms CPU was an upper estimate (its baseline lasted -under a second). A fresh copy of the helper in a new folder took 112 ms on -its first start (105 to 111 ms in runs 7 to 9), against about 34 ms warm. -The figures crept up by about 2 ms of CPU from run 1 to run 6, over an hour -and a half on a host that was also running other work; every run is far -inside the line. +Defender, about 50 ms" left out the starting program, the holder, csrss and +the kernel. Reference: today's HTTP hook POST, taken as the gateway takes it +(a new connection each time, the token checked, the body parsed), took +1.02 ms mean, 1.34 ms p95, and 1.5 ms of CPU, client and server, against a +baseline on the same 150-second schedule (runs 8 and 9: 1.02 and 1.03 ms, +1.5 and 1.6 ms). Run 7's 0.70 ms and 1.0 ms reused one connection and +skipped the token check and the parse, and run 6's 1.1 ms CPU was an upper +estimate (its baseline lasted under a second). A fresh copy of the helper in +a new folder took 112 ms on its first start (105 to 111 ms in runs 7 to 9), +against about 34 ms warm. The figures crept up by about 2 ms of CPU from +run 1 to run 6, over an hour and a half on a host that was also running +other work; every run is far inside the line. Runs 2 to 10 exist because review found gaps in the script's own checks, not in what it measures: a store folder made by someone else, or an output folder diff --git a/README.md b/README.md index 9eb04a151..52d39e613 100644 --- a/README.md +++ b/README.md @@ -93,7 +93,7 @@ On-demand reports over your own usage, Claude Code's and Codex's, runnable acros - **Feature Guide** — a searchable in-app reference with a card for every feature (what it does, how to open it, a tip) plus the complete What's New history, a click away from the sidebar's help button. - **Browser pane** — every session has a browser beside its terminal: an address bar (type `localhost:5173` and press Enter), working history, a home page per config, saved favourites, and a button to open the page in your real browser. Pages load in a sandbox with every permission off. A command button can point it at a dev server as it starts ("watch for a page") or simply open a page; freeze the page to annotate a snapshot in Excalidraw. - **Partner terminal and scratchpad** — every session carries a partner shell in the same tab (on the host, for an SSH session), and a per-session Excalidraw whiteboard that persists with the config; export the drawing straight into the session. -- **Machines and the session helper**: the Machines page on the left rail shows This computer, with its session helper's state, version and self-test and the terminals the helper holds, each with Re-attach and End. The helper is a small program that comes with the app. With **Settings → General → Plain terminals through the session helper** on (a preview, off by default), local Terminal only tabs and the partner terminals of local sessions run inside it, so on Windows they keep running if the app crashes and come back in their tabs when you open it again within two minutes and resume your sessions. A second preview switch, **Settings → General → Claude Code and Codex sessions through the session helper** (also off by default), starts local Claude Code and Codex sessions inside it too, launched exactly as before, and the Machines page lists them with End; they do not survive a crash yet, and after one each tab resumes its conversation. +- **Machines and the session helper**: the Machines page on the left rail shows This computer, with its session helper's state, version and self-test and the terminals the helper holds, each with Re-attach and End. The helper is a small program that comes with the app. With **Settings → General → Plain terminals through the session helper** on (a preview, off by default), local Terminal only tabs and the partner terminals of local sessions run inside it, so on Windows they keep running if the app crashes and come back in their tabs when you open it again within two minutes and resume your sessions. On Windows they also keep running through an app update when you choose Save, and the new version shows them again. A second preview switch, **Settings → General → Claude Code and Codex sessions through the session helper** (also off by default), starts local Claude Code and Codex sessions inside it too, launched exactly as before, and the Machines page lists them with End; they do not survive a crash yet, and after one each tab resumes its conversation. - **Multi-account usage strip** — every signed-in account's usage along the bottom of the window, one pill per person, grouped by provider so Claude Code and Codex figures are never merged, and a minimal mode that shows just the account name and two traffic-light dots (green under 70 %, amber to 89 %, red from 90 %) so the strip stays readable with many accounts. The **Usage page** lists every Claude and Codex account's 5-hour and weekly allowance on one screen. - **Snap and Vision capture** — region or window capture from any screen at 1920px / JPEG 85, a file path inline for local sessions and over the tunnel for SSH; `Alt+V` pastes clipboard images. On a Mac, Snap checks the Screen Recording permission first and, without it, offers to open System Settings instead of capturing. - **A first-run tour and What's New that know where you came from**: a fresh install gets the tour; an update shows what is new since the version you came from (every prerelease of a release shows that release's whole story, and release notes can open with warnings, shown first, including those of any release you skipped), and an update across a release line also walks the tour again. diff --git a/package-lock.json b/package-lock.json index f586150d4..6ea8eba4c 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "claude-conductor", - "version": "2.1.3-beta.7", + "version": "2.1.3-beta.8", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "claude-conductor", - "version": "2.1.3-beta.7", + "version": "2.1.3-beta.8", "hasInstallScript": true, "dependencies": { "@excalidraw/excalidraw": "^0.18.1", diff --git a/package.json b/package.json index 136584f7f..544482774 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "claude-conductor", - "version": "2.1.3-beta.7", + "version": "2.1.3-beta.8", "description": "Multi-session Claude Code and Codex terminal orchestrator", "author": "Nicholas Moger", "main": "./out/main/index.js", diff --git a/src/renderer/changelog.ts b/src/renderer/changelog.ts index 7674d8722..30c8e0d96 100644 --- a/src/renderer/changelog.ts +++ b/src/renderer/changelog.ts @@ -40,6 +40,26 @@ export interface ChangelogEntry { // bracket-matching and tracks string quotes but NOT comments, so an apostrophe or // a backtick in a comment opens a phantom string and the parse fails. export const changelog: ChangelogEntry[] = [ + { + version: '2.1.3-beta.8', + date: '2026-11-18', + highlights: 'On Windows, an app update can now keep the terminals the session helper holds running: choose Save, and the new version shows them again. The session helper no longer needs the Visual C++ runtime on Windows, a Codex review runs on your reviewer account\'s default Codex model, and the vision browser is closed on every way the app exits.', + warnings: [ + 'This beta series begins moving the app\'s background services, and over the next betas your sessions, onto one helper per machine. If you want a quiet build, stay on the stable release.', + 'On Windows, the update to this version still ends the terminals the session helper holds, as before, because the version you update from decides what an update does. From this version on, choosing Save at an update keeps them running, if the new version opens within two minutes of the old one closing. The installer\'s pages count toward those two minutes, so finish the installer promptly.', + 'To go back to 2.1.3-beta.7, download its installer from the GitHub releases page and run it over this version.', + ], + changes: [ + { type: 'feature', description: 'On Windows, with Plain terminals through the session helper on, choosing Save on the update dialog now keeps the terminals the helper holds running through an app update. The new version shows each Terminal only tab and partner terminal again in its tab, with what it printed meanwhile. A held terminal that no tab shows, such as one a crash left, keeps running too, and the Machines page lists it again. Close sessions ends them, as before. The new version must open within two minutes of the old one closing. On macOS and Linux an update still ends them, and Claude Code and Codex sessions still resume their conversation instead.' }, + { type: 'improvement', description: 'With Claude Code and Codex sessions through the session helper on (a preview, off by default) and the HTTP Hooks Gateway on, a Claude Code session the helper holds now sends its hook events to the app through the session helper. The check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway. The attention dot, the hooks feed, the Watchdog and canvas notes work as before, and Codex sessions are unchanged.' }, + { type: 'improvement', description: 'The session helper no longer wakes about 40 times a second for each terminal it holds, to check whether the program in it has ended. It now waits for that program to end instead.' }, + { type: 'fix', description: 'On Windows, the session helper no longer needs Microsoft\'s Visual C++ runtime. Before, on a PC without it the helper could not start, and the app ran without it.' }, + { type: 'fix', description: 'A Codex review now runs on your reviewer account\'s default Codex model, at the same medium reasoning effort. Before, it always asked for GPT-5.5, which OpenAI retired from Codex with ChatGPT sign-in on October 14, 2026.' }, + { type: 'improvement', description: 'Codex reviews, Sentinel\'s analysis on Codex and Codex Insights reports now also run with three more Codex agent features switched off (multi_agent_v2, sleep_tool and the agents setting), which these runs do not need.' }, + { type: 'fix', description: 'On Windows, the vision browser no longer keeps the app\'s files open after the app ends.' }, + { type: 'fix', description: 'The vision browser is now closed on every way the app exits, including an update install.' }, + ], + }, { version: '2.1.3-beta.7', date: '2026-11-17', diff --git a/src/renderer/tips-library.ts b/src/renderer/tips-library.ts index b5e3e29d6..c0e0703cb 100644 --- a/src/renderer/tips-library.ts +++ b/src/renderer/tips-library.ts @@ -1540,4 +1540,22 @@ export const TIPS_LIBRARY: Tip[] = [ }, }, }, + + { + id: 'tip.update-keeps-terminals', + category: 'advanced', + complexity: 'intermediate', + priority: 22, + platforms: ['win32'], + variants: { + primary: { + shortText: 'Save at an update keeps held terminals running', + title: 'Terminals That Live Through an Update', + body: 'With **Plain terminals through the session helper** on (**Settings, General, Terminal**; a preview, off by default), choose **Save** when the app asks before an update. The terminals the session helper holds keep running, and the new version shows each one again in its tab, with what it printed meanwhile.\n\nFinish the installer within **two minutes**: a held terminal waits that long for the new version, counted from when the old one closed. **Close sessions** ends them instead. Claude Code and Codex sessions are not kept: their tabs resume the conversation.', + actionLabel: 'Open Settings', + actionTarget: 'settings', + focusHint: 'Settings -- General, under Terminal', + }, + }, + }, ] diff --git a/src/renderer/training-steps.ts b/src/renderer/training-steps.ts index 915ac06ff..511f94c69 100644 --- a/src/renderer/training-steps.ts +++ b/src/renderer/training-steps.ts @@ -576,7 +576,7 @@ export const trainingSteps: TrainingStep[] = [ 'Opens in the working directory locally; on an SSH session it runs on the host, in the config\'s remote folder once it recognises the host\'s shell prompt, if you have not typed in it first', 'Quick command buttons can target the assistant or the partner explicitly', 'Resize the split bar to favour whichever pane is active', - 'With **Plain terminals through the session helper** on (Settings, General; a preview, off by default), a local session\'s partner terminal keeps running if the app crashes on Windows, and shows again in its session when you open the app again within two minutes and resume your sessions. The assistant\'s own session has a switch of its own, just below it in Settings, General, and after a crash it resumes its conversation instead', + 'With **Plain terminals through the session helper** on (Settings, General; a preview, off by default), a local session\'s partner terminal keeps running if the app crashes on Windows, and shows again in its session when you open the app again within two minutes and resume your sessions. On Windows it also keeps running through an app update when you choose **Save**. The assistant\'s own session has a switch of its own, just below it in Settings, General, and after a crash it resumes its conversation instead', ], howToTrigger: [ { label: 'Toggle', value: 'Partner button in the command bar' }, @@ -674,6 +674,7 @@ export const trainingSteps: TrainingStep[] = [ 'Each held terminal: its name, whether it is a Terminal, a Partner terminal, or a Claude Code or Codex session, when it started, and whether the app is attached or it is **waiting for the app**', '**Re-attach** connects a waiting terminal again, and opens a Terminal only tab for one no tab shows; **End** stops one after you confirm', 'After a crash on Windows, open the app within two minutes and resume your sessions: each held terminal shows again in its tab, with what it printed meanwhile. Quitting normally ends them', + 'On Windows, choose **Save** when you update the app and each held terminal keeps running. If the new version opens within two minutes, it shows them again. **Close sessions** ends them', 'A Claude Code or Codex session has **End** only. After a crash it is ended, reading **Being ended** until it is gone, and its tab resumes the conversation', 'SSH tabs and their partner terminals, a terminal run as administrator, and the tabs the app opens for a sign-in or to install or update a program start as before', 'The page reads when you open it, when you come back to its tab and on **Refresh**', @@ -792,7 +793,7 @@ export const trainingSteps: TrainingStep[] = [ 'Every preference you can set lives here, organised in a left rail. Sandboxed renderer + signed updates + zod-validated IPC keep the app safe; the visible knobs let you tune everything else.', highlights: [ 'General -- default working dir, machine name, update channel, security toggles, and the Tokenomics switch (the usage index can be switched off)', - 'General, under Terminal -- two previews, both off by default. **Plain terminals through the session helper** keeps local Terminal only tabs and local partner terminals running if the app crashes on Windows. **Claude Code and Codex sessions through the session helper** runs local Claude Code and Codex sessions inside the helper. The **Machines** page shows the helper and what it holds', + 'General, under Terminal -- two previews, both off by default. **Plain terminals through the session helper** keeps local Terminal only tabs and local partner terminals running on Windows if the app crashes, or through an update when you choose **Save**. **Claude Code and Codex sessions through the session helper** runs local Claude Code and Codex sessions inside the helper. The **Machines** page shows the helper and what it holds', 'Accounts -- the Providers card (Claude Code and Codex on or off) and every Claude and Codex account', 'Status Line -- toggle each element of the in-terminal status bar + font + size', 'Shortcuts -- rebind every keyboard shortcut', diff --git a/src/shared/app-knowledge.ts b/src/shared/app-knowledge.ts index 22f626e1f..56a006062 100644 --- a/src/shared/app-knowledge.ts +++ b/src/shared/app-knowledge.ts @@ -162,11 +162,11 @@ The page reads the helper when you open it, when you switch back to its tab, whe Two settings in Settings, General, under Terminal, each carry their own kind of session, and either one switches the session helper on. Both are off by default. The setting Plain terminals through the session helper carries Terminal only tabs and partner terminals. The setting Claude Code and Codex sessions through the session helper carries Claude Code and Codex sessions. While both are off the page says so and tells you where to switch them on, and every terminal starts as it always has. A setting switched off while the helper still holds what it carried leaves those listed, with their buttons, until their tabs close or you end them there. -While Plain terminals through the session helper is on, a Terminal only tab on this computer and the partner terminal beside a session on this computer start inside the session helper, a small program installed with the app, instead of under the app itself. They work as before, and they keep running if the app crashes. When the app starts again it finds them at once, and a tab that comes back with the restored sessions shows its terminal again, with what it printed while the app was gone; nothing is typed into it again. A held terminal no tab shows is listed on this page, and Re-attach opens a Terminal only tab on it. A held terminal waits two minutes for the app to come back, and then ends. Quitting the app normally ends every terminal the helper holds. SSH sessions and their partner terminals, a terminal run as administrator, and the tabs the app opens for a sign-in or to install or update a program do not start through it. Claude Code and Codex sessions have their own setting, below. The switch applies to terminals opened after the change; a terminal already open carries on as it started. Surviving a crash is promised on Windows for now: on a Mac or Linux a held terminal may not outlive the app until that has been checked there. Where Windows keeps the session helper inside the app's own job, the card says so, and held terminals then end with the app. The app runs the helper from its own copy in your user folder, checks that copy against the one installed with the app before each use, and makes it again once if it does not match; if it still does not match, the helper reads Failed and terminals start the usual way. +While Plain terminals through the session helper is on, a Terminal only tab on this computer and the partner terminal beside a session on this computer start inside the session helper, a small program installed with the app, instead of under the app itself. They work as before, and they keep running if the app crashes. When the app starts again it finds them at once, and a tab that comes back with the restored sessions shows its terminal again, with what it printed while the app was gone; nothing is typed into it again. A held terminal no tab shows is listed on this page, and Re-attach opens a Terminal only tab on it. A held terminal waits two minutes for the app to come back, and then ends. Quitting the app normally ends every terminal the helper holds. On Windows an app update keeps them when you choose Save on the update dialog: they keep running, and the new version shows each one again in its tab, or lists it on this page if no tab shows it, as after a crash. Close sessions ends them. The new version has the same two minutes, counted from when the old one closed, and while the update runs Re-attach is refused and says the app is being updated. On a Mac or Linux an update still ends them, and Claude Code and Codex sessions are not kept through an update: their tabs resume the conversation. SSH sessions and their partner terminals, a terminal run as administrator, and the tabs the app opens for a sign-in or to install or update a program do not start through it. Claude Code and Codex sessions have their own setting, below. The switch applies to terminals opened after the change; a terminal already open carries on as it started. Surviving a crash is promised on Windows for now: on a Mac or Linux a held terminal may not outlive the app until that has been checked there. Where Windows keeps the session helper inside the app's own job, the card says so, and held terminals then end with the app. The app runs the helper from its own copy in your user folder, checks that copy against the one installed with the app before each use, and makes it again once if it does not match; if it still does not match, the helper reads Failed and terminals start the usual way. -While Claude Code and Codex sessions through the session helper is on, a Claude Code or Codex session on this computer starts inside the session helper, launched exactly as before: the same command, folder, account and settings. Its status line, hooks, the Conductor's tools, the resume list and the Watchdog work as they did, and on Windows a Codex session keeps its scrollback. It does not survive a crash yet. When you open the app again after a crash, the session the helper held is ended and its tab resumes the conversation, as it would without the setting; a session a normal quit could not end in time is ended the same way at the next start. A tab never starts a second Claude Code or Codex on a conversation the helper still runs: it waits until the earlier one has ended. Quitting the app normally ends these sessions. On Windows, ending such a session, whether you close or restart its tab, end it on this page or quit the app, also ends every program it started, even one it opened in a window of its own. SSH sessions do not start through it. The switch applies to sessions started after the change; a session already open carries on as it started. +While Claude Code and Codex sessions through the session helper is on, a Claude Code or Codex session on this computer starts inside the session helper, launched exactly as before: the same command, folder, account and settings. Its status line, hooks, the Conductor's tools, the resume list and the Watchdog work as they did, and on Windows a Codex session keeps its scrollback. With the HTTP Hooks Gateway switch on (Settings, Hooks), a Claude Code session the helper holds sends its hook events to the app through the session helper. Only the check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway. The attention dot, the hooks feed, the Watchdog and canvas notes work as before, and a Codex session sends its hooks as it did. With the setting off, which is the default, every session sends its hooks to the gateway as before. It does not survive a crash yet. When you open the app again after a crash, the session the helper held is ended and its tab resumes the conversation, as it would without the setting; a session a normal quit could not end in time is ended the same way at the next start. A tab never starts a second Claude Code or Codex on a conversation the helper still runs: it waits until the earlier one has ended. Quitting the app normally ends these sessions. On Windows, ending such a session, whether you close or restart its tab, end it on this page or quit the app, also ends every program it started, even one it opened in a window of its own. SSH sessions do not start through it. The switch applies to sessions started after the change; a session already open carries on as it started. -Known issues says what happens to a Claude Code or Codex session the helper held when the app crashes, what to do when the helper reads Failed, when a terminal starts the usual way with the setting on, and how to remove the helper's folder when removing the app leaves it.`, +Known issues says what happens to a Claude Code or Codex session the helper held when the app crashes, why a held terminal can still end during an update, what to do when the helper reads Failed, when a terminal starts the usual way with the setting on, and how to remove the helper's folder when removing the app leaves it.`, }, { id: 'ask-conductor', @@ -420,6 +420,8 @@ A change to your GitHub accounts or settings can be refused with The GitHub sett With Plain terminals through the session helper on, a terminal can still start the usual way, and then does not survive a crash. The session helper takes a terminal only when it can carry it whole. It refuses an environment that has two variables whose names differ only in capitals (http_proxy and HTTP_PROXY, for example), or one far larger than usual (more than 1024 variables, a name over 255 characters, or a value over 32767 characters). Such a terminal starts as it did before the setting and works as before, and the app log says why. A terminal run as administrator always starts the usual way. Workaround: if you want that terminal to survive a crash too and both spellings hold the same value, set the variable under one spelling only, in your system settings or your shell's start-up file, and open the terminal again. Where a program needs both spellings, keep them: the terminal then goes on starting the usual way. +On Windows, with Plain terminals through the session helper on, a terminal the helper keeps through an app update waits two minutes for the new version, counted from when the old version closes. The installer's pages count toward those two minutes, so a held terminal ends if the installer is left open longer: what ran in it stops, and its tab starts a fresh terminal. An update from 2.1.3-beta.7 or earlier runs that version's own update, which still ends every held terminal. Workaround: after you choose Save, finish the installer's pages promptly, within two minutes. If a terminal runs something that must not stop, let it finish before you update. + With either session helper setting on (Plain terminals through the session helper, or Claude Code and Codex sessions through the session helper), the Machines page can read Failed, with the reason, and the Services pill in the title bar then reads Down, in red: for example that the helper could not be copied into place (security software can hold a newly written program open for a while), that its copy does not match the one installed with the app, or that it failed its own self-test. While it reads Failed, terminals and Claude Code and Codex sessions start the usual way, terminals do not survive a crash, and the Session helper card on the Services panel reads crashed, with the same reason; nothing else is affected. Workaround: if the reason says checks failed, press Run self-test on the Machines page to test it again; otherwise open a new Terminal only tab, partner terminal or session a minute or more later, which tries a copy that could not be put in place again, or switch that setting off and on again in Settings, General, which sets the helper up again. With Claude Code and Codex sessions through the session helper on, a Claude Code or Codex session does not survive an app crash yet, unlike a plain terminal the helper holds on Windows. When you open the app again, the session the helper held is ended and its tab resumes the conversation, as it would without the setting; until it is gone, the Machines page lists it as Being ended. Rarely, the helper cannot end the earlier session in time. The tab then says why in one line and starts nothing, so that two copies of Claude Code or Codex never work on one conversation. Workaround: let the tab resume its conversation after the crash. If a tab says it started nothing, restart it a few minutes later, or end that session on the Machines page first and then restart the tab. diff --git a/tests/unit/shared/app-knowledge.test.ts b/tests/unit/shared/app-knowledge.test.ts index 4c6692685..7f1102a95 100644 --- a/tests/unit/shared/app-knowledge.test.ts +++ b/tests/unit/shared/app-knowledge.test.ts @@ -2146,3 +2146,99 @@ describe('the 2.1.3-beta.7 sweep', () => { expect(`${entry.highlights}\n${all}`).not.toMatch(/less work/i) }) }) + +// 2.1.3-beta.8 user-facing sweep: on Windows an update with Save keeps the +// terminals the session helper holds (#713, #717), held Claude Code sessions +// send their hooks through the helper (#718, off by default), the helper's +// wait for its program (#710) and its own C runtime (#719), the Codex review's +// model (#712) and the vision browser's two fixes (#715), so a later edit +// cannot drop them silently. +describe('the 2.1.3-beta.8 sweep', () => { + const PLAIN_SWITCH = 'Plain terminals through the session helper' + const body = (id: string) => APP_KNOWLEDGE_SECTIONS.find((x) => x.id === id)!.body + const tipOf = (id: string) => TIPS_LIBRARY.find((t) => t.id === id)! + const step = (id: string) => trainingSteps.find((s) => s.id === id)! + const entry = changelog.find((e) => e.version === '2.1.3-beta.8')! + const readme = () => fs.readFileSync(path.resolve(__dirname, '..', '..', '..', 'README.md'), 'utf8') + + it('the Machines section says an update with Save keeps held terminals on Windows, and what still ends them', () => { + const m = body('machines') + expect(m).toContain('On Windows an app update keeps them when you choose Save on the update dialog') + expect(m).toContain('or lists it on this page if no tab shows it, as after a crash. Close sessions ends them.') + expect(m).toContain('The new version has the same two minutes, counted from when the old one closed') + expect(m).toContain('Re-attach is refused and says the app is being updated') + expect(m).toContain('On a Mac or Linux an update still ends them') + expect(m).toContain('Claude Code and Codex sessions are not kept through an update: their tabs resume the conversation') + expect(m).toContain('why a held terminal can still end during an update') + }) + + it('the Machines section says a held Claude Code session sends its hooks through the helper, PreToolUse still to the gateway, off by default', () => { + const m = body('machines') + expect(m).toContain('a Claude Code session the helper holds sends its hook events to the app through the session helper') + expect(m).toContain('Only the check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway') + expect(m).toContain('a Codex session sends its hooks as it did') + expect(m).toContain('With the setting off, which is the default, every session sends its hooks to the gateway as before') + }) + + it('a known issue says the two minutes run through the installer, with its workaround', () => { + const k = body('known-issues') + expect(k).toContain("The installer's pages count toward those two minutes, so a held terminal ends if the installer is left open longer") + expect(k).toContain("Workaround: after you choose Save, finish the installer's pages promptly, within two minutes") + expect(k).toContain("An update from 2.1.3-beta.7 or earlier runs that version's own update, which still ends every held terminal") + }) + + it('no surface says the helper needs the Visual C++ runtime, or that Save at an update ends a terminal a crash kept', () => { + const all = [ + ...APP_KNOWLEDGE_SECTIONS.map((s) => s.body), + ...TIPS_LIBRARY.map((t) => t.variants.primary.body), + JSON.stringify(trainingSteps), + readme(), + ].join('\n') + expect(all).not.toMatch(/Visual C\+\+|VCRUNTIME/i) + expect(all).not.toMatch(/Re-attach it first to keep it/i) + }) + + it('a Windows tip for Save at an update, and the cards and the README say it', () => { + const t = tipOf('tip.update-keeps-terminals') + expect(t.platforms).toEqual(['win32']) + expect(t.provider).toBeUndefined() + expect(t.variants.primary.shortText.length).toBeLessThan(60) + expect(t.variants.primary.actionTarget).toBe('settings') + expect(t.variants.primary.body).toContain(`**${PLAIN_SWITCH}**`) + expect(t.variants.primary.body).toContain('choose **Save** when the app asks before an update') + expect(t.variants.primary.body).toContain('Finish the installer within **two minutes**') + expect(t.variants.primary.body).toContain('**Close sessions** ends them instead') + expect(`${t.variants.primary.title} ${t.variants.primary.body}`).not.toMatch(/—/) + expect(step('machines').highlights.join('\n')).toContain('On Windows, choose **Save** when you update the app and each held terminal keeps running') + expect(step('settings').highlights.join('\n')).toContain('or through an update when you choose **Save**') + // Combined Mode reads the same for either assistant, so it names no provider. + expect(step('combined-mode').highlights.join('\n')).toContain('On Windows it also keeps running through an app update when you choose **Save**') + const line = readme().split('\n').find((l) => l.startsWith('- **Machines and the session helper**'))! + expect(line).toContain('On Windows they also keep running through an app update when you choose Save') + }) + + it('the release notes carry the update warning, the way back and every change line', () => { + const w = entry.warnings!.join('\n') + expect(w).toContain("This beta series begins moving the app's background services") + expect(w).toContain('the update to this version still ends the terminals the session helper holds') + expect(w).toContain('the version you update from decides what an update does') + expect(w).toContain('To go back to 2.1.3-beta.7') + const all = entry.changes.map((c) => c.description).join('\n') + for (const said of [ + 'choosing Save on the update dialog now keeps the terminals the helper holds running through an app update', + 'A held terminal that no tab shows, such as one a crash left, keeps running too', + 'Close sessions ends them, as before', + 'a Claude Code session the helper holds now sends its hook events to the app through the session helper', + 'a preview, off by default', + 'no longer wakes about 40 times a second', + "no longer needs Microsoft's Visual C++ runtime", + "runs on your reviewer account's default Codex model", + 'multi_agent_v2, sleep_tool and the agents setting', + "the vision browser no longer keeps the app's files open after the app ends", + 'closed on every way the app exits, including an update install', + ]) expect(all).toContain(said) + for (const text of [entry.highlights ?? '', ...entry.warnings!, ...entry.changes.map((c) => c.description)]) expect(text, text.slice(0, 40)).not.toMatch(/—/) + // #710 measured no CPU figure, so no line claims one. + expect(`${entry.highlights}\n${all}`).not.toMatch(/less work|faster|% CPU/i) + }) +}) From 53f72d6745718666719bbfd6a9da5fb4e607ac9e Mon Sep 17 00:00:00 2001 From: nubbymong <192402368+nubbymong@users.noreply.github.com> Date: Wed, 18 Nov 2026 12:58:42 +0000 Subject: [PATCH 2/6] docs(changelog): name only what a user sees in the beta.8 hooks line The app shows no hooks feed for a Claude Code session, so the beta.8 change line and the Machines section now name the attention dot, the Watchdog and canvas notes only. Co-Authored-By: Claude Opus 5.5 --- CHANGELOG.md | 2 +- src/renderer/changelog.ts | 2 +- src/shared/app-knowledge.ts | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1a3cecc36..ebf822626 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -22,7 +22,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - On Windows, with Plain terminals through the session helper on, choosing Save on the update dialog now keeps the terminals the helper holds running through an app update. The new version shows each Terminal only tab and partner terminal again in its tab, with what it printed meanwhile. A held terminal that no tab shows, such as one a crash left, keeps running too, and the Machines page lists it again. Close sessions ends them, as before. The new version must open within two minutes of the old one closing. On macOS and Linux an update still ends them, and Claude Code and Codex sessions still resume their conversation instead. ### Changed -- With Claude Code and Codex sessions through the session helper on (a preview, off by default) and the HTTP Hooks Gateway on, a Claude Code session the helper holds now sends its hook events to the app through the session helper. The check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway. The attention dot, the hooks feed, the Watchdog and canvas notes work as before, and Codex sessions are unchanged. +- With Claude Code and Codex sessions through the session helper on (a preview, off by default) and the HTTP Hooks Gateway on, a Claude Code session the helper holds now sends its hook events to the app through the session helper. The check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway. The attention dot, the Watchdog and canvas notes work as before, and Codex sessions are unchanged. - The session helper no longer wakes about 40 times a second for each terminal it holds, to check whether the program in it has ended. It now waits for that program to end instead. - Codex reviews, Sentinel's analysis on Codex and Codex Insights reports now also run with three more Codex agent features switched off (multi_agent_v2, sleep_tool and the agents setting), which these runs do not need. diff --git a/src/renderer/changelog.ts b/src/renderer/changelog.ts index 30c8e0d96..002e75e29 100644 --- a/src/renderer/changelog.ts +++ b/src/renderer/changelog.ts @@ -51,7 +51,7 @@ export const changelog: ChangelogEntry[] = [ ], changes: [ { type: 'feature', description: 'On Windows, with Plain terminals through the session helper on, choosing Save on the update dialog now keeps the terminals the helper holds running through an app update. The new version shows each Terminal only tab and partner terminal again in its tab, with what it printed meanwhile. A held terminal that no tab shows, such as one a crash left, keeps running too, and the Machines page lists it again. Close sessions ends them, as before. The new version must open within two minutes of the old one closing. On macOS and Linux an update still ends them, and Claude Code and Codex sessions still resume their conversation instead.' }, - { type: 'improvement', description: 'With Claude Code and Codex sessions through the session helper on (a preview, off by default) and the HTTP Hooks Gateway on, a Claude Code session the helper holds now sends its hook events to the app through the session helper. The check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway. The attention dot, the hooks feed, the Watchdog and canvas notes work as before, and Codex sessions are unchanged.' }, + { type: 'improvement', description: 'With Claude Code and Codex sessions through the session helper on (a preview, off by default) and the HTTP Hooks Gateway on, a Claude Code session the helper holds now sends its hook events to the app through the session helper. The check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway. The attention dot, the Watchdog and canvas notes work as before, and Codex sessions are unchanged.' }, { type: 'improvement', description: 'The session helper no longer wakes about 40 times a second for each terminal it holds, to check whether the program in it has ended. It now waits for that program to end instead.' }, { type: 'fix', description: 'On Windows, the session helper no longer needs Microsoft\'s Visual C++ runtime. Before, on a PC without it the helper could not start, and the app ran without it.' }, { type: 'fix', description: 'A Codex review now runs on your reviewer account\'s default Codex model, at the same medium reasoning effort. Before, it always asked for GPT-5.5, which OpenAI retired from Codex with ChatGPT sign-in on October 14, 2026.' }, diff --git a/src/shared/app-knowledge.ts b/src/shared/app-knowledge.ts index 56a006062..f807103e5 100644 --- a/src/shared/app-knowledge.ts +++ b/src/shared/app-knowledge.ts @@ -164,7 +164,7 @@ Two settings in Settings, General, under Terminal, each carry their own kind of While Plain terminals through the session helper is on, a Terminal only tab on this computer and the partner terminal beside a session on this computer start inside the session helper, a small program installed with the app, instead of under the app itself. They work as before, and they keep running if the app crashes. When the app starts again it finds them at once, and a tab that comes back with the restored sessions shows its terminal again, with what it printed while the app was gone; nothing is typed into it again. A held terminal no tab shows is listed on this page, and Re-attach opens a Terminal only tab on it. A held terminal waits two minutes for the app to come back, and then ends. Quitting the app normally ends every terminal the helper holds. On Windows an app update keeps them when you choose Save on the update dialog: they keep running, and the new version shows each one again in its tab, or lists it on this page if no tab shows it, as after a crash. Close sessions ends them. The new version has the same two minutes, counted from when the old one closed, and while the update runs Re-attach is refused and says the app is being updated. On a Mac or Linux an update still ends them, and Claude Code and Codex sessions are not kept through an update: their tabs resume the conversation. SSH sessions and their partner terminals, a terminal run as administrator, and the tabs the app opens for a sign-in or to install or update a program do not start through it. Claude Code and Codex sessions have their own setting, below. The switch applies to terminals opened after the change; a terminal already open carries on as it started. Surviving a crash is promised on Windows for now: on a Mac or Linux a held terminal may not outlive the app until that has been checked there. Where Windows keeps the session helper inside the app's own job, the card says so, and held terminals then end with the app. The app runs the helper from its own copy in your user folder, checks that copy against the one installed with the app before each use, and makes it again once if it does not match; if it still does not match, the helper reads Failed and terminals start the usual way. -While Claude Code and Codex sessions through the session helper is on, a Claude Code or Codex session on this computer starts inside the session helper, launched exactly as before: the same command, folder, account and settings. Its status line, hooks, the Conductor's tools, the resume list and the Watchdog work as they did, and on Windows a Codex session keeps its scrollback. With the HTTP Hooks Gateway switch on (Settings, Hooks), a Claude Code session the helper holds sends its hook events to the app through the session helper. Only the check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway. The attention dot, the hooks feed, the Watchdog and canvas notes work as before, and a Codex session sends its hooks as it did. With the setting off, which is the default, every session sends its hooks to the gateway as before. It does not survive a crash yet. When you open the app again after a crash, the session the helper held is ended and its tab resumes the conversation, as it would without the setting; a session a normal quit could not end in time is ended the same way at the next start. A tab never starts a second Claude Code or Codex on a conversation the helper still runs: it waits until the earlier one has ended. Quitting the app normally ends these sessions. On Windows, ending such a session, whether you close or restart its tab, end it on this page or quit the app, also ends every program it started, even one it opened in a window of its own. SSH sessions do not start through it. The switch applies to sessions started after the change; a session already open carries on as it started. +While Claude Code and Codex sessions through the session helper is on, a Claude Code or Codex session on this computer starts inside the session helper, launched exactly as before: the same command, folder, account and settings. Its status line, hooks, the Conductor's tools, the resume list and the Watchdog work as they did, and on Windows a Codex session keeps its scrollback. With the HTTP Hooks Gateway switch on (Settings, Hooks), a Claude Code session the helper holds sends its hook events to the app through the session helper. Only the check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway. The attention dot, the Watchdog and canvas notes work as before, and a Codex session sends its hooks as it did. With the setting off, which is the default, every session sends its hooks to the gateway as before. It does not survive a crash yet. When you open the app again after a crash, the session the helper held is ended and its tab resumes the conversation, as it would without the setting; a session a normal quit could not end in time is ended the same way at the next start. A tab never starts a second Claude Code or Codex on a conversation the helper still runs: it waits until the earlier one has ended. Quitting the app normally ends these sessions. On Windows, ending such a session, whether you close or restart its tab, end it on this page or quit the app, also ends every program it started, even one it opened in a window of its own. SSH sessions do not start through it. The switch applies to sessions started after the change; a session already open carries on as it started. Known issues says what happens to a Claude Code or Codex session the helper held when the app crashes, why a held terminal can still end during an update, what to do when the helper reads Failed, when a terminal starts the usual way with the setting on, and how to remove the helper's folder when removing the app leaves it.`, }, From 00ad7568617ad2ed4b5d6d5cb38b58fa6c22f88b Mon Sep 17 00:00:00 2001 From: nubbymong <192402368+nubbymong@users.noreply.github.com> Date: Wed, 18 Nov 2026 13:36:59 +0000 Subject: [PATCH 3/6] docs(release): name Save sessions and narrow what an update keeps in the beta.8 text The update dialog's button is "Save sessions", so every beta.8 surface now names it that way: the changelog entry, app-knowledge, the tip, the three Feature Guide cards, the README and the Settings note, which now also says the update keeps terminals only with Save sessions. The Machines card says an update keeps a held Terminal or Partner terminal, and that an update ends a held Claude Code or Codex session. The known issue says an older version's update ends the held terminals open in tabs, as before, not every held terminal. The hooks sentence names its own setting, and the installer paragraph says an update leaves the helper's folder in place. A code comment in vision-manager.ts no longer says the helper needs the Visual C++ runtime (comment only, no behaviour change). The beta.8 sweep pins follow, with new pins for the Settings note, the dialog's button name, the agent-session card line, and a guard that no surface calls the button "Save". CHANGELOG.md regenerated. Co-Authored-By: Claude Opus 5.5 --- CHANGELOG.md | 8 ++-- README.md | 2 +- src/main/vision-manager.ts | 7 ++-- src/renderer/changelog.ts | 8 ++-- src/renderer/components/SettingsPage.tsx | 2 +- src/renderer/tips-library.ts | 4 +- src/renderer/training-steps.ts | 8 ++-- src/shared/app-knowledge.ts | 8 ++-- tests/unit/shared/app-knowledge.test.ts | 47 ++++++++++++++++-------- 9 files changed, 56 insertions(+), 38 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ebf822626..1f88258c4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,13 +13,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ### Warnings - This beta series begins moving the app's background services, and over the next betas your sessions, onto one helper per machine. If you want a quiet build, stay on the stable release. -- On Windows, the update to this version still ends the terminals the session helper holds, as before, because the version you update from decides what an update does. From this version on, choosing Save at an update keeps them running, if the new version opens within two minutes of the old one closing. The installer's pages count toward those two minutes, so finish the installer promptly. +- On Windows, the update to this version still ends the terminals the session helper holds, as before, because the version you update from decides what an update does. From this version on, choosing Save sessions at an update keeps them running, if the new version opens within two minutes of the old one closing. The installer's pages count toward those two minutes, so finish the installer promptly. - To go back to 2.1.3-beta.7, download its installer from the GitHub releases page and run it over this version. -> On Windows, an app update can now keep the terminals the session helper holds running: choose Save, and the new version shows them again. The session helper no longer needs the Visual C++ runtime on Windows, a Codex review runs on your reviewer account's default Codex model, and the vision browser is closed on every way the app exits. +> On Windows, an app update can now keep the terminals the session helper holds running: choose Save sessions, and the new version shows them again. The session helper no longer needs the Visual C++ runtime on Windows, a Codex review runs on your reviewer account's default Codex model, and the vision browser is closed on every way the app exits. ### Added -- On Windows, with Plain terminals through the session helper on, choosing Save on the update dialog now keeps the terminals the helper holds running through an app update. The new version shows each Terminal only tab and partner terminal again in its tab, with what it printed meanwhile. A held terminal that no tab shows, such as one a crash left, keeps running too, and the Machines page lists it again. Close sessions ends them, as before. The new version must open within two minutes of the old one closing. On macOS and Linux an update still ends them, and Claude Code and Codex sessions still resume their conversation instead. +- On Windows, with Plain terminals through the session helper on, choosing Save sessions on the update dialog now keeps the terminals the helper holds running through an app update. The new version shows each Terminal only tab and partner terminal again in its tab, with what it printed meanwhile. A held terminal that no tab shows, such as one a crash left, keeps running too, and the Machines page lists it again. Close sessions ends them, as before. The new version must open within two minutes of the old one closing. On macOS and Linux an update still ends them, and Claude Code and Codex sessions still resume their conversation instead. ### Changed - With Claude Code and Codex sessions through the session helper on (a preview, off by default) and the HTTP Hooks Gateway on, a Claude Code session the helper holds now sends its hook events to the app through the session helper. The check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway. The attention dot, the Watchdog and canvas notes work as before, and Codex sessions are unchanged. @@ -27,7 +27,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Codex reviews, Sentinel's analysis on Codex and Codex Insights reports now also run with three more Codex agent features switched off (multi_agent_v2, sleep_tool and the agents setting), which these runs do not need. ### Fixed -- On Windows, the session helper no longer needs Microsoft's Visual C++ runtime. Before, on a PC without it the helper could not start, and the app ran without it. +- On Windows, the session helper no longer needs Microsoft's Visual C++ runtime. Before, on a PC without it the helper could not start, and terminals started the usual way. - A Codex review now runs on your reviewer account's default Codex model, at the same medium reasoning effort. Before, it always asked for GPT-5.5, which OpenAI retired from Codex with ChatGPT sign-in on October 14, 2026. - On Windows, the vision browser no longer keeps the app's files open after the app ends. - The vision browser is now closed on every way the app exits, including an update install. diff --git a/README.md b/README.md index 52d39e613..eced59368 100644 --- a/README.md +++ b/README.md @@ -93,7 +93,7 @@ On-demand reports over your own usage, Claude Code's and Codex's, runnable acros - **Feature Guide** — a searchable in-app reference with a card for every feature (what it does, how to open it, a tip) plus the complete What's New history, a click away from the sidebar's help button. - **Browser pane** — every session has a browser beside its terminal: an address bar (type `localhost:5173` and press Enter), working history, a home page per config, saved favourites, and a button to open the page in your real browser. Pages load in a sandbox with every permission off. A command button can point it at a dev server as it starts ("watch for a page") or simply open a page; freeze the page to annotate a snapshot in Excalidraw. - **Partner terminal and scratchpad** — every session carries a partner shell in the same tab (on the host, for an SSH session), and a per-session Excalidraw whiteboard that persists with the config; export the drawing straight into the session. -- **Machines and the session helper**: the Machines page on the left rail shows This computer, with its session helper's state, version and self-test and the terminals the helper holds, each with Re-attach and End. The helper is a small program that comes with the app. With **Settings → General → Plain terminals through the session helper** on (a preview, off by default), local Terminal only tabs and the partner terminals of local sessions run inside it, so on Windows they keep running if the app crashes and come back in their tabs when you open it again within two minutes and resume your sessions. On Windows they also keep running through an app update when you choose Save, and the new version shows them again. A second preview switch, **Settings → General → Claude Code and Codex sessions through the session helper** (also off by default), starts local Claude Code and Codex sessions inside it too, launched exactly as before, and the Machines page lists them with End; they do not survive a crash yet, and after one each tab resumes its conversation. +- **Machines and the session helper**: the Machines page on the left rail shows This computer, with its session helper's state, version and self-test and the terminals the helper holds, each with Re-attach and End. The helper is a small program that comes with the app. With **Settings → General → Plain terminals through the session helper** on (a preview, off by default), local Terminal only tabs and the partner terminals of local sessions run inside it, so on Windows they keep running if the app crashes and come back in their tabs when you open it again within two minutes and resume your sessions. On Windows they also keep running through an app update when you choose Save sessions, and the new version shows them again. A second preview switch, **Settings → General → Claude Code and Codex sessions through the session helper** (also off by default), starts local Claude Code and Codex sessions inside it too, launched exactly as before, and the Machines page lists them with End; they do not survive a crash yet, and after one each tab resumes its conversation. - **Multi-account usage strip** — every signed-in account's usage along the bottom of the window, one pill per person, grouped by provider so Claude Code and Codex figures are never merged, and a minimal mode that shows just the account name and two traffic-light dots (green under 70 %, amber to 89 %, red from 90 %) so the strip stays readable with many accounts. The **Usage page** lists every Claude and Codex account's 5-hour and weekly allowance on one screen. - **Snap and Vision capture** — region or window capture from any screen at 1920px / JPEG 85, a file path inline for local sessions and over the tunnel for SSH; `Alt+V` pastes clipboard images. On a Mac, Snap checks the Screen Recording permission first and, without it, offers to open System Settings instead of capturing. - **A first-run tour and What's New that know where you came from**: a fresh install gets the tour; an update shows what is new since the version you came from (every prerelease of a release shows that release's whole story, and release notes can open with warnings, shown first, including those of any release you skipped), and an update across a release line also walks the tour again. diff --git a/src/main/vision-manager.ts b/src/main/vision-manager.ts index 357906986..8a8eedeeb 100644 --- a/src/main/vision-manager.ts +++ b/src/main/vision-manager.ts @@ -1040,9 +1040,10 @@ async function startThroughHelper(executable: string, args: string[], headless: /** * The exit statuses Windows ends a program with when it cannot load it, before * any of the program's own code runs, as Node reports them (unsigned): a DLL - * it needs is missing (0xC0000135, the helper needs the Visual C++ runtime), - * a DLL lacks a function it needs (0xC0000139), a file is not a program this - * Windows can run (0xC000007B), or a DLL failed to start (0xC0000142). + * it needs is missing (0xC0000135, as for a helper built before 2.1.3-beta.8 + * on a PC without the Visual C++ runtime), a DLL lacks a function it needs + * (0xC0000139), a file is not a program this Windows can run (0xC000007B), or + * a DLL failed to start (0xC0000142). */ const HELPER_NOT_LOADED = new Set([3221225781, 3221225785, 3221225595, 3221225794]) diff --git a/src/renderer/changelog.ts b/src/renderer/changelog.ts index 002e75e29..678f81a59 100644 --- a/src/renderer/changelog.ts +++ b/src/renderer/changelog.ts @@ -43,17 +43,17 @@ export const changelog: ChangelogEntry[] = [ { version: '2.1.3-beta.8', date: '2026-11-18', - highlights: 'On Windows, an app update can now keep the terminals the session helper holds running: choose Save, and the new version shows them again. The session helper no longer needs the Visual C++ runtime on Windows, a Codex review runs on your reviewer account\'s default Codex model, and the vision browser is closed on every way the app exits.', + highlights: 'On Windows, an app update can now keep the terminals the session helper holds running: choose Save sessions, and the new version shows them again. The session helper no longer needs the Visual C++ runtime on Windows, a Codex review runs on your reviewer account\'s default Codex model, and the vision browser is closed on every way the app exits.', warnings: [ 'This beta series begins moving the app\'s background services, and over the next betas your sessions, onto one helper per machine. If you want a quiet build, stay on the stable release.', - 'On Windows, the update to this version still ends the terminals the session helper holds, as before, because the version you update from decides what an update does. From this version on, choosing Save at an update keeps them running, if the new version opens within two minutes of the old one closing. The installer\'s pages count toward those two minutes, so finish the installer promptly.', + 'On Windows, the update to this version still ends the terminals the session helper holds, as before, because the version you update from decides what an update does. From this version on, choosing Save sessions at an update keeps them running, if the new version opens within two minutes of the old one closing. The installer\'s pages count toward those two minutes, so finish the installer promptly.', 'To go back to 2.1.3-beta.7, download its installer from the GitHub releases page and run it over this version.', ], changes: [ - { type: 'feature', description: 'On Windows, with Plain terminals through the session helper on, choosing Save on the update dialog now keeps the terminals the helper holds running through an app update. The new version shows each Terminal only tab and partner terminal again in its tab, with what it printed meanwhile. A held terminal that no tab shows, such as one a crash left, keeps running too, and the Machines page lists it again. Close sessions ends them, as before. The new version must open within two minutes of the old one closing. On macOS and Linux an update still ends them, and Claude Code and Codex sessions still resume their conversation instead.' }, + { type: 'feature', description: 'On Windows, with Plain terminals through the session helper on, choosing Save sessions on the update dialog now keeps the terminals the helper holds running through an app update. The new version shows each Terminal only tab and partner terminal again in its tab, with what it printed meanwhile. A held terminal that no tab shows, such as one a crash left, keeps running too, and the Machines page lists it again. Close sessions ends them, as before. The new version must open within two minutes of the old one closing. On macOS and Linux an update still ends them, and Claude Code and Codex sessions still resume their conversation instead.' }, { type: 'improvement', description: 'With Claude Code and Codex sessions through the session helper on (a preview, off by default) and the HTTP Hooks Gateway on, a Claude Code session the helper holds now sends its hook events to the app through the session helper. The check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway. The attention dot, the Watchdog and canvas notes work as before, and Codex sessions are unchanged.' }, { type: 'improvement', description: 'The session helper no longer wakes about 40 times a second for each terminal it holds, to check whether the program in it has ended. It now waits for that program to end instead.' }, - { type: 'fix', description: 'On Windows, the session helper no longer needs Microsoft\'s Visual C++ runtime. Before, on a PC without it the helper could not start, and the app ran without it.' }, + { type: 'fix', description: 'On Windows, the session helper no longer needs Microsoft\'s Visual C++ runtime. Before, on a PC without it the helper could not start, and terminals started the usual way.' }, { type: 'fix', description: 'A Codex review now runs on your reviewer account\'s default Codex model, at the same medium reasoning effort. Before, it always asked for GPT-5.5, which OpenAI retired from Codex with ChatGPT sign-in on October 14, 2026.' }, { type: 'improvement', description: 'Codex reviews, Sentinel\'s analysis on Codex and Codex Insights reports now also run with three more Codex agent features switched off (multi_agent_v2, sleep_tool and the agents setting), which these runs do not need.' }, { type: 'fix', description: 'On Windows, the vision browser no longer keeps the app\'s files open after the app ends.' }, diff --git a/src/renderer/components/SettingsPage.tsx b/src/renderer/components/SettingsPage.tsx index 734ef8a1d..207f3caf2 100644 --- a/src/renderer/components/SettingsPage.tsx +++ b/src/renderer/components/SettingsPage.tsx @@ -623,7 +623,7 @@ export default function SettingsPage({ initialTab, onNavigateToSessions, onUpdat /> Plain terminals through the session helper - Preview, off by default. A Terminal only tab and the partner terminal of a session on this computer start inside the session helper. On Windows they keep running if the app crashes, and come back with their tabs if you open it again within two minutes and resume your sessions. On Windows they also keep running through an app update, for up to two minutes until the new version opens. Claude Code and Codex sessions have their own switch below, and SSH sessions are not affected. Quitting normally ends them. Applies to terminals opened after the change. The Machines page shows the helper and what it holds. + Preview, off by default. A Terminal only tab and the partner terminal of a session on this computer start inside the session helper. On Windows they keep running if the app crashes, and come back with their tabs if you open it again within two minutes and resume your sessions. On Windows they also keep running through an app update when you choose Save sessions, for up to two minutes until the new version opens. Claude Code and Codex sessions have their own switch below, and SSH sessions are not affected. Quitting normally ends them. Applies to terminals opened after the change. The Machines page shows the helper and what it holds. {/* 2.1.3-beta.7 (plan section A3): agent sessions through the session helper, a preview. */} diff --git a/src/renderer/tips-library.ts b/src/renderer/tips-library.ts index c0e0703cb..621e675a5 100644 --- a/src/renderer/tips-library.ts +++ b/src/renderer/tips-library.ts @@ -1549,9 +1549,9 @@ export const TIPS_LIBRARY: Tip[] = [ platforms: ['win32'], variants: { primary: { - shortText: 'Save at an update keeps held terminals running', + shortText: 'Save sessions at an update keeps held terminals running', title: 'Terminals That Live Through an Update', - body: 'With **Plain terminals through the session helper** on (**Settings, General, Terminal**; a preview, off by default), choose **Save** when the app asks before an update. The terminals the session helper holds keep running, and the new version shows each one again in its tab, with what it printed meanwhile.\n\nFinish the installer within **two minutes**: a held terminal waits that long for the new version, counted from when the old one closed. **Close sessions** ends them instead. Claude Code and Codex sessions are not kept: their tabs resume the conversation.', + body: 'With **Plain terminals through the session helper** on (**Settings, General, Terminal**; a preview, off by default), choose **Save sessions** when the app asks before an update. The terminals the session helper holds keep running, and the new version shows each one again in its tab, with what it printed meanwhile.\n\nFinish the installer within **two minutes**: a held terminal waits that long for the new version, counted from when the old one closed. **Close sessions** ends them instead. Claude Code and Codex sessions are not kept: their tabs resume the conversation.', actionLabel: 'Open Settings', actionTarget: 'settings', focusHint: 'Settings -- General, under Terminal', diff --git a/src/renderer/training-steps.ts b/src/renderer/training-steps.ts index 511f94c69..058597ec6 100644 --- a/src/renderer/training-steps.ts +++ b/src/renderer/training-steps.ts @@ -576,7 +576,7 @@ export const trainingSteps: TrainingStep[] = [ 'Opens in the working directory locally; on an SSH session it runs on the host, in the config\'s remote folder once it recognises the host\'s shell prompt, if you have not typed in it first', 'Quick command buttons can target the assistant or the partner explicitly', 'Resize the split bar to favour whichever pane is active', - 'With **Plain terminals through the session helper** on (Settings, General; a preview, off by default), a local session\'s partner terminal keeps running if the app crashes on Windows, and shows again in its session when you open the app again within two minutes and resume your sessions. On Windows it also keeps running through an app update when you choose **Save**. The assistant\'s own session has a switch of its own, just below it in Settings, General, and after a crash it resumes its conversation instead', + 'With **Plain terminals through the session helper** on (Settings, General; a preview, off by default), a local session\'s partner terminal keeps running if the app crashes on Windows, and shows again in its session when you open the app again within two minutes and resume your sessions. On Windows it also keeps running through an app update when you choose **Save sessions**. The assistant\'s own session has a switch of its own, just below it in Settings, General, and after a crash it resumes its conversation instead', ], howToTrigger: [ { label: 'Toggle', value: 'Partner button in the command bar' }, @@ -674,8 +674,8 @@ export const trainingSteps: TrainingStep[] = [ 'Each held terminal: its name, whether it is a Terminal, a Partner terminal, or a Claude Code or Codex session, when it started, and whether the app is attached or it is **waiting for the app**', '**Re-attach** connects a waiting terminal again, and opens a Terminal only tab for one no tab shows; **End** stops one after you confirm', 'After a crash on Windows, open the app within two minutes and resume your sessions: each held terminal shows again in its tab, with what it printed meanwhile. Quitting normally ends them', - 'On Windows, choose **Save** when you update the app and each held terminal keeps running. If the new version opens within two minutes, it shows them again. **Close sessions** ends them', - 'A Claude Code or Codex session has **End** only. After a crash it is ended, reading **Being ended** until it is gone, and its tab resumes the conversation', + 'On Windows, choose **Save sessions** when you update the app and each held Terminal or Partner terminal keeps running. If the new version opens within two minutes, it shows them again. **Close sessions** ends them', + 'A Claude Code or Codex session has **End** only. An update ends it, and after a crash it is ended, reading **Being ended** until it is gone. Either way its tab resumes the conversation', 'SSH tabs and their partner terminals, a terminal run as administrator, and the tabs the app opens for a sign-in or to install or update a program start as before', 'The page reads when you open it, when you come back to its tab and on **Refresh**', ], @@ -793,7 +793,7 @@ export const trainingSteps: TrainingStep[] = [ 'Every preference you can set lives here, organised in a left rail. Sandboxed renderer + signed updates + zod-validated IPC keep the app safe; the visible knobs let you tune everything else.', highlights: [ 'General -- default working dir, machine name, update channel, security toggles, and the Tokenomics switch (the usage index can be switched off)', - 'General, under Terminal -- two previews, both off by default. **Plain terminals through the session helper** keeps local Terminal only tabs and local partner terminals running on Windows if the app crashes, or through an update when you choose **Save**. **Claude Code and Codex sessions through the session helper** runs local Claude Code and Codex sessions inside the helper. The **Machines** page shows the helper and what it holds', + 'General, under Terminal -- two previews, both off by default. **Plain terminals through the session helper** keeps local Terminal only tabs and local partner terminals running on Windows if the app crashes, or through an update when you choose **Save sessions**. **Claude Code and Codex sessions through the session helper** runs local Claude Code and Codex sessions inside the helper. The **Machines** page shows the helper and what it holds', 'Accounts -- the Providers card (Claude Code and Codex on or off) and every Claude and Codex account', 'Status Line -- toggle each element of the in-terminal status bar + font + size', 'Shortcuts -- rebind every keyboard shortcut', diff --git a/src/shared/app-knowledge.ts b/src/shared/app-knowledge.ts index f807103e5..bb6fe4989 100644 --- a/src/shared/app-knowledge.ts +++ b/src/shared/app-knowledge.ts @@ -105,7 +105,7 @@ The pill follows the worst card. It says Starting or Restarting, in amber, while At least one provider always stays on, and a provider cannot be turned off while anything of it is running: its sessions, its cloud agents, a review, a sign-in, a Sentinel check or analysis, or an Insights report. The row then says the provider is in use and how many things are using it; close them and switch it off again. A provider that is off starts nowhere. Its saved configs say why instead of launching, and a tab that was restored or restarted for it reads Not started, names the provider and points at Settings, Accounts. The same holds when a Claude Code launch on an account is waiting for a sign-in refresh or for the check of the project settings: it asks again when the wait ends, and if its provider is off by then, or the app cannot read whether it is on, nothing starts and the tab says why. A Restart or Switch Account whose launch is refused after it waited says why in the tab before its session ends. The tab and its conversation are kept: turn the provider back on, then Restart the tab. With Claude Code off, Insights runs for Codex accounts only, Ask Conductor runs on Codex, Cloud Agents runs Codex agents only, and Terminal only configs still run. The Feature Guide and its tour show the cards for the assistants you use: with Codex alone, the cards for features that need Claude Code (Dynamic Workflows and Multiple Accounts) and Code review are not shown, and with Claude Code alone, Code review is not shown, since it needs both. The Cloud Agents card, under Integrations, is shown for either assistant; with Codex alone it describes Codex agents only. Tips are not filtered by assistant: a tip about something only one assistant has carries that assistant's mark, Claude Code's or Codex's, beside its title on the tip card and in the sidebar's tip row, and a tip about both, or about the app itself, carries none. -On Windows the installer opens with a Welcome page, then asks for the Data folder (sessions, logs and configuration data) and the Resources folder (shared insights, screenshots, skills and scripts), then whether to install for you or for everyone, and where. On an upgrade, every one of those pages comes up with the earlier install's choices already selected. Updates from inside the app run the same pages and keep the folders you chose. Uninstalling removes the program but leaves both folders; if your resources folder holds a CONFIG folder, the uninstaller asks whether to remove that too. It also ends the terminals and sessions the session helper still holds for you, and removes the session helper's own folder, with its copies and records; an update keeps them. Every page of the installer and the uninstaller has the same light look, with the brand in the header and the side art. +On Windows the installer opens with a Welcome page, then asks for the Data folder (sessions, logs and configuration data) and the Resources folder (shared insights, screenshots, skills and scripts), then whether to install for you or for everyone, and where. On an upgrade, every one of those pages comes up with the earlier install's choices already selected. Updates from inside the app run the same pages and keep the folders you chose. Uninstalling removes the program but leaves both folders; if your resources folder holds a CONFIG folder, the uninstaller asks whether to remove that too. It also ends the terminals and sessions the session helper still holds for you, and removes the session helper's own folder, with its copies and records; an update leaves that folder in place. Every page of the installer and the uninstaller has the same light look, with the brand in the header and the side art. Setup's first step saves two folders: the data directory and the resources directory. Each must be a full path, for example one with a drive letter or a network share (\\\\server\\share) on Windows, or one starting with / on macOS and Linux. If either folder is empty, is not a full path, cannot be created or cannot be saved, setup stays on that step and says which folder could not be saved. Windows saves the folders in the registry; macOS and Linux save them in the app's settings file in your home folder. Choose another folder and press Continue again. Continue, the folder fields and Browse wait while the folders are being saved. A fresh install asks Which assistants will you use? during setup (Claude Code, Codex, or both), and you can change the answer later in Settings, Accounts. If Claude Code is not installed, the first setup screen says so and lists its install commands, Anthropic's native installer first and npm second, each with Run it for me and Copy: Run it for me runs the command in a terminal on that screen once you confirm it, and setup checks again when it ends and carries on as soon as Claude Code is found. That screen also offers Use Codex only, which turns Claude Code off and Codex on. Choosing Codex during setup leads to the Set up Codex page. It checks for the Codex command line tool, offers its install or update commands the same way (OpenAI's installer first, then npm, and Homebrew on a Mac; Run it for me types the command into a visible terminal tab after you confirm it, and the page checks again when it ends), and then signs you in to a new Codex account.`, }, @@ -162,9 +162,9 @@ The page reads the helper when you open it, when you switch back to its tab, whe Two settings in Settings, General, under Terminal, each carry their own kind of session, and either one switches the session helper on. Both are off by default. The setting Plain terminals through the session helper carries Terminal only tabs and partner terminals. The setting Claude Code and Codex sessions through the session helper carries Claude Code and Codex sessions. While both are off the page says so and tells you where to switch them on, and every terminal starts as it always has. A setting switched off while the helper still holds what it carried leaves those listed, with their buttons, until their tabs close or you end them there. -While Plain terminals through the session helper is on, a Terminal only tab on this computer and the partner terminal beside a session on this computer start inside the session helper, a small program installed with the app, instead of under the app itself. They work as before, and they keep running if the app crashes. When the app starts again it finds them at once, and a tab that comes back with the restored sessions shows its terminal again, with what it printed while the app was gone; nothing is typed into it again. A held terminal no tab shows is listed on this page, and Re-attach opens a Terminal only tab on it. A held terminal waits two minutes for the app to come back, and then ends. Quitting the app normally ends every terminal the helper holds. On Windows an app update keeps them when you choose Save on the update dialog: they keep running, and the new version shows each one again in its tab, or lists it on this page if no tab shows it, as after a crash. Close sessions ends them. The new version has the same two minutes, counted from when the old one closed, and while the update runs Re-attach is refused and says the app is being updated. On a Mac or Linux an update still ends them, and Claude Code and Codex sessions are not kept through an update: their tabs resume the conversation. SSH sessions and their partner terminals, a terminal run as administrator, and the tabs the app opens for a sign-in or to install or update a program do not start through it. Claude Code and Codex sessions have their own setting, below. The switch applies to terminals opened after the change; a terminal already open carries on as it started. Surviving a crash is promised on Windows for now: on a Mac or Linux a held terminal may not outlive the app until that has been checked there. Where Windows keeps the session helper inside the app's own job, the card says so, and held terminals then end with the app. The app runs the helper from its own copy in your user folder, checks that copy against the one installed with the app before each use, and makes it again once if it does not match; if it still does not match, the helper reads Failed and terminals start the usual way. +While Plain terminals through the session helper is on, a Terminal only tab on this computer and the partner terminal beside a session on this computer start inside the session helper, a small program installed with the app, instead of under the app itself. They work as before, and they keep running if the app crashes. When the app starts again it finds them at once, and a tab that comes back with the restored sessions shows its terminal again, with what it printed while the app was gone; nothing is typed into it again. A held terminal no tab shows is listed on this page, and Re-attach opens a Terminal only tab on it. A held terminal waits two minutes for the app to come back, and then ends. Quitting the app normally ends every terminal the helper holds. On Windows an app update keeps them when you choose Save sessions on the update dialog: they keep running, and the new version shows each one again in its tab, or lists it on this page if no tab shows it, as after a crash. Close sessions ends them. The new version has the same two minutes, counted from when the old one closed, and while the update runs Re-attach is refused and says the app is being updated. On a Mac or Linux an update still ends them, and Claude Code and Codex sessions are not kept through an update: their tabs resume the conversation. SSH sessions and their partner terminals, a terminal run as administrator, and the tabs the app opens for a sign-in or to install or update a program do not start through it. Claude Code and Codex sessions have their own setting, below. The switch applies to terminals opened after the change; a terminal already open carries on as it started. Surviving a crash is promised on Windows for now: on a Mac or Linux a held terminal may not outlive the app until that has been checked there. Where Windows keeps the session helper inside the app's own job, the card says so, and held terminals then end with the app. The app runs the helper from its own copy in your user folder, checks that copy against the one installed with the app before each use, and makes it again once if it does not match; if it still does not match, the helper reads Failed and terminals start the usual way. -While Claude Code and Codex sessions through the session helper is on, a Claude Code or Codex session on this computer starts inside the session helper, launched exactly as before: the same command, folder, account and settings. Its status line, hooks, the Conductor's tools, the resume list and the Watchdog work as they did, and on Windows a Codex session keeps its scrollback. With the HTTP Hooks Gateway switch on (Settings, Hooks), a Claude Code session the helper holds sends its hook events to the app through the session helper. Only the check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway. The attention dot, the Watchdog and canvas notes work as before, and a Codex session sends its hooks as it did. With the setting off, which is the default, every session sends its hooks to the gateway as before. It does not survive a crash yet. When you open the app again after a crash, the session the helper held is ended and its tab resumes the conversation, as it would without the setting; a session a normal quit could not end in time is ended the same way at the next start. A tab never starts a second Claude Code or Codex on a conversation the helper still runs: it waits until the earlier one has ended. Quitting the app normally ends these sessions. On Windows, ending such a session, whether you close or restart its tab, end it on this page or quit the app, also ends every program it started, even one it opened in a window of its own. SSH sessions do not start through it. The switch applies to sessions started after the change; a session already open carries on as it started. +While Claude Code and Codex sessions through the session helper is on, a Claude Code or Codex session on this computer starts inside the session helper, launched exactly as before: the same command, folder, account and settings. Its status line, hooks, the Conductor's tools, the resume list and the Watchdog work as they did, and on Windows a Codex session keeps its scrollback. With the HTTP Hooks Gateway switch on (Settings, Hooks), a Claude Code session the helper holds sends its hook events to the app through the session helper. Only the check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway. The attention dot, the Watchdog and canvas notes work as before, and a Codex session sends its hooks as it did. With Claude Code and Codex sessions through the session helper off, which is the default, every session sends its hooks to the gateway as before. It does not survive a crash yet. When you open the app again after a crash, the session the helper held is ended and its tab resumes the conversation, as it would without the setting; a session a normal quit could not end in time is ended the same way at the next start. A tab never starts a second Claude Code or Codex on a conversation the helper still runs: it waits until the earlier one has ended. Quitting the app normally ends these sessions. On Windows, ending such a session, whether you close or restart its tab, end it on this page or quit the app, also ends every program it started, even one it opened in a window of its own. SSH sessions do not start through it. The switch applies to sessions started after the change; a session already open carries on as it started. Known issues says what happens to a Claude Code or Codex session the helper held when the app crashes, why a held terminal can still end during an update, what to do when the helper reads Failed, when a terminal starts the usual way with the setting on, and how to remove the helper's folder when removing the app leaves it.`, }, @@ -420,7 +420,7 @@ A change to your GitHub accounts or settings can be refused with The GitHub sett With Plain terminals through the session helper on, a terminal can still start the usual way, and then does not survive a crash. The session helper takes a terminal only when it can carry it whole. It refuses an environment that has two variables whose names differ only in capitals (http_proxy and HTTP_PROXY, for example), or one far larger than usual (more than 1024 variables, a name over 255 characters, or a value over 32767 characters). Such a terminal starts as it did before the setting and works as before, and the app log says why. A terminal run as administrator always starts the usual way. Workaround: if you want that terminal to survive a crash too and both spellings hold the same value, set the variable under one spelling only, in your system settings or your shell's start-up file, and open the terminal again. Where a program needs both spellings, keep them: the terminal then goes on starting the usual way. -On Windows, with Plain terminals through the session helper on, a terminal the helper keeps through an app update waits two minutes for the new version, counted from when the old version closes. The installer's pages count toward those two minutes, so a held terminal ends if the installer is left open longer: what ran in it stops, and its tab starts a fresh terminal. An update from 2.1.3-beta.7 or earlier runs that version's own update, which still ends every held terminal. Workaround: after you choose Save, finish the installer's pages promptly, within two minutes. If a terminal runs something that must not stop, let it finish before you update. +On Windows, with Plain terminals through the session helper on, a terminal the helper keeps through an app update waits two minutes for the new version, counted from when the old version closes. The installer's pages count toward those two minutes, so a held terminal ends if the installer is left open longer: what ran in it stops, and its tab starts a fresh terminal. An update from 2.1.3-beta.7 or earlier runs that version's own update, which still ends the held terminals open in tabs, as before. Workaround: after you choose Save sessions, finish the installer's pages promptly, within two minutes. If a terminal runs something that must not stop, let it finish before you update. With either session helper setting on (Plain terminals through the session helper, or Claude Code and Codex sessions through the session helper), the Machines page can read Failed, with the reason, and the Services pill in the title bar then reads Down, in red: for example that the helper could not be copied into place (security software can hold a newly written program open for a while), that its copy does not match the one installed with the app, or that it failed its own self-test. While it reads Failed, terminals and Claude Code and Codex sessions start the usual way, terminals do not survive a crash, and the Session helper card on the Services panel reads crashed, with the same reason; nothing else is affected. Workaround: if the reason says checks failed, press Run self-test on the Machines page to test it again; otherwise open a new Terminal only tab, partner terminal or session a minute or more later, which tries a copy that could not be put in place again, or switch that setting off and on again in Settings, General, which sets the helper up again. diff --git a/tests/unit/shared/app-knowledge.test.ts b/tests/unit/shared/app-knowledge.test.ts index 7f1102a95..262b7d295 100644 --- a/tests/unit/shared/app-knowledge.test.ts +++ b/tests/unit/shared/app-knowledge.test.ts @@ -2086,7 +2086,7 @@ describe('the 2.1.3-beta.7 sweep', () => { it('the installer paragraph says the uninstaller removes the helper folder and the pages share one look', () => { const p = APP_KNOWLEDGE_SECTIONS.map((s) => s.body).find((b) => b.includes('On Windows the installer opens with a Welcome page'))! - expect(p).toContain("removes the session helper's own folder, with its copies and records; an update keeps them") + expect(p).toContain("removes the session helper's own folder, with its copies and records; an update leaves that folder in place") expect(p).toContain('Every page of the installer and the uninstaller has the same light look') }) @@ -2147,7 +2147,7 @@ describe('the 2.1.3-beta.7 sweep', () => { }) }) -// 2.1.3-beta.8 user-facing sweep: on Windows an update with Save keeps the +// 2.1.3-beta.8 user-facing sweep: on Windows an update with Save sessions keeps the // terminals the session helper holds (#713, #717), held Claude Code sessions // send their hooks through the helper (#718, off by default), the helper's // wait for its program (#710) and its own C runtime (#719), the Codex review's @@ -2161,9 +2161,9 @@ describe('the 2.1.3-beta.8 sweep', () => { const entry = changelog.find((e) => e.version === '2.1.3-beta.8')! const readme = () => fs.readFileSync(path.resolve(__dirname, '..', '..', '..', 'README.md'), 'utf8') - it('the Machines section says an update with Save keeps held terminals on Windows, and what still ends them', () => { + it('the Machines section says an update with Save sessions keeps held terminals on Windows, and what still ends them', () => { const m = body('machines') - expect(m).toContain('On Windows an app update keeps them when you choose Save on the update dialog') + expect(m).toContain('On Windows an app update keeps them when you choose Save sessions on the update dialog') expect(m).toContain('or lists it on this page if no tab shows it, as after a crash. Close sessions ends them.') expect(m).toContain('The new version has the same two minutes, counted from when the old one closed') expect(m).toContain('Re-attach is refused and says the app is being updated') @@ -2177,17 +2177,21 @@ describe('the 2.1.3-beta.8 sweep', () => { expect(m).toContain('a Claude Code session the helper holds sends its hook events to the app through the session helper') expect(m).toContain('Only the check before each tool runs (PreToolUse) still goes to the HTTP Hooks Gateway') expect(m).toContain('a Codex session sends its hooks as it did') - expect(m).toContain('With the setting off, which is the default, every session sends its hooks to the gateway as before') + // It names its own setting: the HTTP Hooks Gateway just before it is on by default. + expect(m).toContain('With Claude Code and Codex sessions through the session helper off, which is the default, every session sends its hooks to the gateway as before') + expect(m).not.toContain('With the setting off, which is the default') }) it('a known issue says the two minutes run through the installer, with its workaround', () => { const k = body('known-issues') expect(k).toContain("The installer's pages count toward those two minutes, so a held terminal ends if the installer is left open longer") - expect(k).toContain("Workaround: after you choose Save, finish the installer's pages promptly, within two minutes") - expect(k).toContain("An update from 2.1.3-beta.7 or earlier runs that version's own update, which still ends every held terminal") + expect(k).toContain("Workaround: after you choose Save sessions, finish the installer's pages promptly, within two minutes") + // An older version's update ended only the terminals the app was attached to (#717). + expect(k).toContain("An update from 2.1.3-beta.7 or earlier runs that version's own update, which still ends the held terminals open in tabs, as before") + expect(k).not.toContain('which still ends every held terminal') }) - it('no surface says the helper needs the Visual C++ runtime, or that Save at an update ends a terminal a crash kept', () => { + it('no surface says the helper needs the Visual C++ runtime, or that Save sessions at an update ends a terminal a crash kept', () => { const all = [ ...APP_KNOWLEDGE_SECTIONS.map((s) => s.body), ...TIPS_LIBRARY.map((t) => t.variants.primary.body), @@ -2196,25 +2200,37 @@ describe('the 2.1.3-beta.8 sweep', () => { ].join('\n') expect(all).not.toMatch(/Visual C\+\+|VCRUNTIME/i) expect(all).not.toMatch(/Re-attach it first to keep it/i) + // The update dialog's button is "Save sessions", so no surface calls it "Save". + const notes = [entry.highlights ?? '', ...entry.warnings!, ...entry.changes.map((c) => c.description)].join('\n') + expect(`${all}\n${notes}`).not.toMatch(/\bchoos(?:e|ing) (?:\*\*)?Save\b(?! sessions)/) }) - it('a Windows tip for Save at an update, and the cards and the README say it', () => { + it('a Windows tip for Save sessions at an update, and the cards, the Settings note and the README say it', () => { const t = tipOf('tip.update-keeps-terminals') expect(t.platforms).toEqual(['win32']) expect(t.provider).toBeUndefined() expect(t.variants.primary.shortText.length).toBeLessThan(60) expect(t.variants.primary.actionTarget).toBe('settings') expect(t.variants.primary.body).toContain(`**${PLAIN_SWITCH}**`) - expect(t.variants.primary.body).toContain('choose **Save** when the app asks before an update') + expect(t.variants.primary.shortText).toContain('Save sessions') + expect(t.variants.primary.body).toContain('choose **Save sessions** when the app asks before an update') expect(t.variants.primary.body).toContain('Finish the installer within **two minutes**') expect(t.variants.primary.body).toContain('**Close sessions** ends them instead') expect(`${t.variants.primary.title} ${t.variants.primary.body}`).not.toMatch(/—/) - expect(step('machines').highlights.join('\n')).toContain('On Windows, choose **Save** when you update the app and each held terminal keeps running') - expect(step('settings').highlights.join('\n')).toContain('or through an update when you choose **Save**') + const machines = step('machines').highlights.join('\n') + expect(machines).toContain('On Windows, choose **Save sessions** when you update the app and each held Terminal or Partner terminal keeps running') + // Agent sessions the helper holds still end at an update (#713). + expect(machines).toContain('A Claude Code or Codex session has **End** only. An update ends it, and after a crash it is ended') + expect(step('settings').highlights.join('\n')).toContain('or through an update when you choose **Save sessions**') // Combined Mode reads the same for either assistant, so it names no provider. - expect(step('combined-mode').highlights.join('\n')).toContain('On Windows it also keeps running through an app update when you choose **Save**') + expect(step('combined-mode').highlights.join('\n')).toContain('On Windows it also keeps running through an app update when you choose **Save sessions**') const line = readme().split('\n').find((l) => l.startsWith('- **Machines and the session helper**'))! - expect(line).toContain('On Windows they also keep running through an app update when you choose Save') + expect(line).toContain('On Windows they also keep running through an app update when you choose Save sessions') + const settingsPage = fs.readFileSync(path.resolve(__dirname, '..', '..', '..', 'src', 'renderer', 'components', 'SettingsPage.tsx'), 'utf8') + expect(settingsPage).toContain('On Windows they also keep running through an app update when you choose Save sessions, for up to two minutes until the new version opens.') + // The update dialog's button is named exactly, as every other surface names it. + const dialog = fs.readFileSync(path.resolve(__dirname, '..', '..', '..', 'src', 'renderer', 'components', 'CloseDialog.tsx'), 'utf8') + expect(dialog).toContain('>Save sessions') }) it('the release notes carry the update warning, the way back and every change line', () => { @@ -2225,7 +2241,8 @@ describe('the 2.1.3-beta.8 sweep', () => { expect(w).toContain('To go back to 2.1.3-beta.7') const all = entry.changes.map((c) => c.description).join('\n') for (const said of [ - 'choosing Save on the update dialog now keeps the terminals the helper holds running through an app update', + 'choosing Save sessions on the update dialog now keeps the terminals the helper holds running through an app update', + 'on a PC without it the helper could not start, and terminals started the usual way', 'A held terminal that no tab shows, such as one a crash left, keeps running too', 'Close sessions ends them, as before', 'a Claude Code session the helper holds now sends its hook events to the app through the session helper', From 7929e26672b7968ead6a45a0be0d46bf13df9d39 Mon Sep 17 00:00:00 2001 From: nubbymong <192402368+nubbymong@users.noreply.github.com> Date: Wed, 18 Nov 2026 13:58:34 +0000 Subject: [PATCH 4/6] docs(changelog): the beta.8 update warning names only the terminals open in tabs Re-review of 00ad7568: the What's New warning still said the update to beta.8 ends every terminal the session helper holds. Under beta.7's own update a terminal a crash kept, with no tab showing it, ran on (#717), so the warning now says what the known issue already says: it ends the held terminals open in tabs, as before. The pin follows; it is red with the old sentence put back. CHANGELOG.md regenerated. Co-Authored-By: Claude Opus 5.5 --- CHANGELOG.md | 2 +- src/renderer/changelog.ts | 2 +- tests/unit/shared/app-knowledge.test.ts | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1f88258c4..490a03839 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,7 +13,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ### Warnings - This beta series begins moving the app's background services, and over the next betas your sessions, onto one helper per machine. If you want a quiet build, stay on the stable release. -- On Windows, the update to this version still ends the terminals the session helper holds, as before, because the version you update from decides what an update does. From this version on, choosing Save sessions at an update keeps them running, if the new version opens within two minutes of the old one closing. The installer's pages count toward those two minutes, so finish the installer promptly. +- On Windows, the update to this version still ends the held terminals open in tabs, as before, because the version you update from decides what an update does. From this version on, choosing Save sessions at an update keeps them running, if the new version opens within two minutes of the old one closing. The installer's pages count toward those two minutes, so finish the installer promptly. - To go back to 2.1.3-beta.7, download its installer from the GitHub releases page and run it over this version. > On Windows, an app update can now keep the terminals the session helper holds running: choose Save sessions, and the new version shows them again. The session helper no longer needs the Visual C++ runtime on Windows, a Codex review runs on your reviewer account's default Codex model, and the vision browser is closed on every way the app exits. diff --git a/src/renderer/changelog.ts b/src/renderer/changelog.ts index 678f81a59..9f0f54953 100644 --- a/src/renderer/changelog.ts +++ b/src/renderer/changelog.ts @@ -46,7 +46,7 @@ export const changelog: ChangelogEntry[] = [ highlights: 'On Windows, an app update can now keep the terminals the session helper holds running: choose Save sessions, and the new version shows them again. The session helper no longer needs the Visual C++ runtime on Windows, a Codex review runs on your reviewer account\'s default Codex model, and the vision browser is closed on every way the app exits.', warnings: [ 'This beta series begins moving the app\'s background services, and over the next betas your sessions, onto one helper per machine. If you want a quiet build, stay on the stable release.', - 'On Windows, the update to this version still ends the terminals the session helper holds, as before, because the version you update from decides what an update does. From this version on, choosing Save sessions at an update keeps them running, if the new version opens within two minutes of the old one closing. The installer\'s pages count toward those two minutes, so finish the installer promptly.', + 'On Windows, the update to this version still ends the held terminals open in tabs, as before, because the version you update from decides what an update does. From this version on, choosing Save sessions at an update keeps them running, if the new version opens within two minutes of the old one closing. The installer\'s pages count toward those two minutes, so finish the installer promptly.', 'To go back to 2.1.3-beta.7, download its installer from the GitHub releases page and run it over this version.', ], changes: [ diff --git a/tests/unit/shared/app-knowledge.test.ts b/tests/unit/shared/app-knowledge.test.ts index 262b7d295..79ca9f041 100644 --- a/tests/unit/shared/app-knowledge.test.ts +++ b/tests/unit/shared/app-knowledge.test.ts @@ -2236,7 +2236,7 @@ describe('the 2.1.3-beta.8 sweep', () => { it('the release notes carry the update warning, the way back and every change line', () => { const w = entry.warnings!.join('\n') expect(w).toContain("This beta series begins moving the app's background services") - expect(w).toContain('the update to this version still ends the terminals the session helper holds') + expect(w).toContain('the update to this version still ends the held terminals open in tabs') expect(w).toContain('the version you update from decides what an update does') expect(w).toContain('To go back to 2.1.3-beta.7') const all = entry.changes.map((c) => c.description).join('\n') From 921e40457e8abe2a83c1e609719a6d35e59a6956 Mon Sep 17 00:00:00 2001 From: nubbymong <192402368+nubbymong@users.noreply.github.com> Date: Wed, 18 Nov 2026 14:15:52 +0000 Subject: [PATCH 5/6] docs(release): the beta.8 notes and Feature Guide cover the installer's app check (#720) C3 (#720) merged after this PR was built; beta is merged in. What's New gains one fix line: the installer closes only your own copy from the folder being installed, leaves other users' copies and the session helper alone, waits while the app shows its save dialog, and a silent install no longer waits on a box nobody can see. It promises no graceful close over a remote sign-in, where the copy is ended after the wait. The Feature Guide's installer paragraph gains the matching sentence (answer the dialog, then Retry). Both are pinned. CHANGELOG.md regenerated. Co-Authored-By: Claude Opus 5.5 --- CHANGELOG.md | 1 + src/renderer/changelog.ts | 1 + src/shared/app-knowledge.ts | 2 +- tests/unit/shared/app-knowledge.test.ts | 8 ++++++++ 4 files changed, 11 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 490a03839..0c0d02315 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -31,6 +31,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - A Codex review now runs on your reviewer account's default Codex model, at the same medium reasoning effort. Before, it always asked for GPT-5.5, which OpenAI retired from Codex with ChatGPT sign-in on October 14, 2026. - On Windows, the vision browser no longer keeps the app's files open after the app ends. - The vision browser is now closed on every way the app exits, including an update install. +- On Windows, the installer now closes only your own copy of AI Code Conductor that runs from the folder being installed. Other users' copies and the session helper are left alone. It asks the app to close first, and while the app shows its save dialog the installer waits for you instead of ending it. A silent install over a remote or scheduled sign-in no longer waits forever on a box nobody can see. ## [2.1.3-beta.7] - 2026-11-17 diff --git a/src/renderer/changelog.ts b/src/renderer/changelog.ts index 9f0f54953..92ded3fb1 100644 --- a/src/renderer/changelog.ts +++ b/src/renderer/changelog.ts @@ -58,6 +58,7 @@ export const changelog: ChangelogEntry[] = [ { type: 'improvement', description: 'Codex reviews, Sentinel\'s analysis on Codex and Codex Insights reports now also run with three more Codex agent features switched off (multi_agent_v2, sleep_tool and the agents setting), which these runs do not need.' }, { type: 'fix', description: 'On Windows, the vision browser no longer keeps the app\'s files open after the app ends.' }, { type: 'fix', description: 'The vision browser is now closed on every way the app exits, including an update install.' }, + { type: 'fix', description: 'On Windows, the installer now closes only your own copy of AI Code Conductor that runs from the folder being installed. Other users\' copies and the session helper are left alone. It asks the app to close first, and while the app shows its save dialog the installer waits for you instead of ending it. A silent install over a remote or scheduled sign-in no longer waits forever on a box nobody can see.' }, ], }, { diff --git a/src/shared/app-knowledge.ts b/src/shared/app-knowledge.ts index bb6fe4989..a5f0c6991 100644 --- a/src/shared/app-knowledge.ts +++ b/src/shared/app-knowledge.ts @@ -105,7 +105,7 @@ The pill follows the worst card. It says Starting or Restarting, in amber, while At least one provider always stays on, and a provider cannot be turned off while anything of it is running: its sessions, its cloud agents, a review, a sign-in, a Sentinel check or analysis, or an Insights report. The row then says the provider is in use and how many things are using it; close them and switch it off again. A provider that is off starts nowhere. Its saved configs say why instead of launching, and a tab that was restored or restarted for it reads Not started, names the provider and points at Settings, Accounts. The same holds when a Claude Code launch on an account is waiting for a sign-in refresh or for the check of the project settings: it asks again when the wait ends, and if its provider is off by then, or the app cannot read whether it is on, nothing starts and the tab says why. A Restart or Switch Account whose launch is refused after it waited says why in the tab before its session ends. The tab and its conversation are kept: turn the provider back on, then Restart the tab. With Claude Code off, Insights runs for Codex accounts only, Ask Conductor runs on Codex, Cloud Agents runs Codex agents only, and Terminal only configs still run. The Feature Guide and its tour show the cards for the assistants you use: with Codex alone, the cards for features that need Claude Code (Dynamic Workflows and Multiple Accounts) and Code review are not shown, and with Claude Code alone, Code review is not shown, since it needs both. The Cloud Agents card, under Integrations, is shown for either assistant; with Codex alone it describes Codex agents only. Tips are not filtered by assistant: a tip about something only one assistant has carries that assistant's mark, Claude Code's or Codex's, beside its title on the tip card and in the sidebar's tip row, and a tip about both, or about the app itself, carries none. -On Windows the installer opens with a Welcome page, then asks for the Data folder (sessions, logs and configuration data) and the Resources folder (shared insights, screenshots, skills and scripts), then whether to install for you or for everyone, and where. On an upgrade, every one of those pages comes up with the earlier install's choices already selected. Updates from inside the app run the same pages and keep the folders you chose. Uninstalling removes the program but leaves both folders; if your resources folder holds a CONFIG folder, the uninstaller asks whether to remove that too. It also ends the terminals and sessions the session helper still holds for you, and removes the session helper's own folder, with its copies and records; an update leaves that folder in place. Every page of the installer and the uninstaller has the same light look, with the brand in the header and the side art. +On Windows the installer opens with a Welcome page, then asks for the Data folder (sessions, logs and configuration data) and the Resources folder (shared insights, screenshots, skills and scripts), then whether to install for you or for everyone, and where. On an upgrade, every one of those pages comes up with the earlier install's choices already selected. Updates from inside the app run the same pages and keep the folders you chose. If your own copy of AI Code Conductor is still running from the folder being installed, the installer asks it to close and leaves other users' copies and the session helper alone; while the app shows its save dialog, the installer waits, so answer the dialog and then choose Retry. Uninstalling removes the program but leaves both folders; if your resources folder holds a CONFIG folder, the uninstaller asks whether to remove that too. It also ends the terminals and sessions the session helper still holds for you, and removes the session helper's own folder, with its copies and records; an update leaves that folder in place. Every page of the installer and the uninstaller has the same light look, with the brand in the header and the side art. Setup's first step saves two folders: the data directory and the resources directory. Each must be a full path, for example one with a drive letter or a network share (\\\\server\\share) on Windows, or one starting with / on macOS and Linux. If either folder is empty, is not a full path, cannot be created or cannot be saved, setup stays on that step and says which folder could not be saved. Windows saves the folders in the registry; macOS and Linux save them in the app's settings file in your home folder. Choose another folder and press Continue again. Continue, the folder fields and Browse wait while the folders are being saved. A fresh install asks Which assistants will you use? during setup (Claude Code, Codex, or both), and you can change the answer later in Settings, Accounts. If Claude Code is not installed, the first setup screen says so and lists its install commands, Anthropic's native installer first and npm second, each with Run it for me and Copy: Run it for me runs the command in a terminal on that screen once you confirm it, and setup checks again when it ends and carries on as soon as Claude Code is found. That screen also offers Use Codex only, which turns Claude Code off and Codex on. Choosing Codex during setup leads to the Set up Codex page. It checks for the Codex command line tool, offers its install or update commands the same way (OpenAI's installer first, then npm, and Homebrew on a Mac; Run it for me types the command into a visible terminal tab after you confirm it, and the page checks again when it ends), and then signs you in to a new Codex account.`, }, diff --git a/tests/unit/shared/app-knowledge.test.ts b/tests/unit/shared/app-knowledge.test.ts index 79ca9f041..043070f63 100644 --- a/tests/unit/shared/app-knowledge.test.ts +++ b/tests/unit/shared/app-knowledge.test.ts @@ -2161,6 +2161,12 @@ describe('the 2.1.3-beta.8 sweep', () => { const entry = changelog.find((e) => e.version === '2.1.3-beta.8')! const readme = () => fs.readFileSync(path.resolve(__dirname, '..', '..', '..', 'README.md'), 'utf8') + it('the installer paragraph says the app check closes only your own copy and waits at its save dialog (#720)', () => { + const p = body('providers') + expect(p).toContain('If your own copy of AI Code Conductor is still running from the folder being installed, the installer asks it to close') + expect(p).toContain('while the app shows its save dialog, the installer waits, so answer the dialog and then choose Retry') + }) + it('the Machines section says an update with Save sessions keeps held terminals on Windows, and what still ends them', () => { const m = body('machines') expect(m).toContain('On Windows an app update keeps them when you choose Save sessions on the update dialog') @@ -2253,6 +2259,8 @@ describe('the 2.1.3-beta.8 sweep', () => { 'multi_agent_v2, sleep_tool and the agents setting', "the vision browser no longer keeps the app's files open after the app ends", 'closed on every way the app exits, including an update install', + 'the installer now closes only your own copy of AI Code Conductor that runs from the folder being installed', + 'while the app shows its save dialog the installer waits for you instead of ending it', ]) expect(all).toContain(said) for (const text of [entry.highlights ?? '', ...entry.warnings!, ...entry.changes.map((c) => c.description)]) expect(text, text.slice(0, 40)).not.toMatch(/—/) // #710 measured no CPU figure, so no line claims one. From b9e0dfd9677d4ead372580d047d0cc216c9ee3bd Mon Sep 17 00:00:00 2001 From: nubbymong <192402368+nubbymong@users.noreply.github.com> Date: Wed, 18 Nov 2026 14:44:12 +0000 Subject: [PATCH 6/6] docs(release): scope the installer lines to a normal install and a showing Retry box Re-review of 921e4045, two wording nits: the What's New line now says the ask-and-wait happens in a normal install (a silent run ends the copy after the wait), and the Feature Guide sentence says to choose Retry only if the installer's box is showing (the box appears only after the 5-second wait). Pins follow; CHANGELOG.md regenerated. Co-Authored-By: Claude Opus 5.5 --- CHANGELOG.md | 2 +- src/renderer/changelog.ts | 2 +- src/shared/app-knowledge.ts | 2 +- tests/unit/shared/app-knowledge.test.ts | 4 ++-- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 0c0d02315..bba706880 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -31,7 +31,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - A Codex review now runs on your reviewer account's default Codex model, at the same medium reasoning effort. Before, it always asked for GPT-5.5, which OpenAI retired from Codex with ChatGPT sign-in on October 14, 2026. - On Windows, the vision browser no longer keeps the app's files open after the app ends. - The vision browser is now closed on every way the app exits, including an update install. -- On Windows, the installer now closes only your own copy of AI Code Conductor that runs from the folder being installed. Other users' copies and the session helper are left alone. It asks the app to close first, and while the app shows its save dialog the installer waits for you instead of ending it. A silent install over a remote or scheduled sign-in no longer waits forever on a box nobody can see. +- On Windows, the installer now closes only your own copy of AI Code Conductor that runs from the folder being installed. Other users' copies and the session helper are left alone. In a normal install it asks the app to close first, and while the app shows its save dialog the installer waits for you instead of ending it. A silent install over a remote or scheduled sign-in no longer waits forever on a box nobody can see. ## [2.1.3-beta.7] - 2026-11-17 diff --git a/src/renderer/changelog.ts b/src/renderer/changelog.ts index 92ded3fb1..80854cdc4 100644 --- a/src/renderer/changelog.ts +++ b/src/renderer/changelog.ts @@ -58,7 +58,7 @@ export const changelog: ChangelogEntry[] = [ { type: 'improvement', description: 'Codex reviews, Sentinel\'s analysis on Codex and Codex Insights reports now also run with three more Codex agent features switched off (multi_agent_v2, sleep_tool and the agents setting), which these runs do not need.' }, { type: 'fix', description: 'On Windows, the vision browser no longer keeps the app\'s files open after the app ends.' }, { type: 'fix', description: 'The vision browser is now closed on every way the app exits, including an update install.' }, - { type: 'fix', description: 'On Windows, the installer now closes only your own copy of AI Code Conductor that runs from the folder being installed. Other users\' copies and the session helper are left alone. It asks the app to close first, and while the app shows its save dialog the installer waits for you instead of ending it. A silent install over a remote or scheduled sign-in no longer waits forever on a box nobody can see.' }, + { type: 'fix', description: 'On Windows, the installer now closes only your own copy of AI Code Conductor that runs from the folder being installed. Other users\' copies and the session helper are left alone. In a normal install it asks the app to close first, and while the app shows its save dialog the installer waits for you instead of ending it. A silent install over a remote or scheduled sign-in no longer waits forever on a box nobody can see.' }, ], }, { diff --git a/src/shared/app-knowledge.ts b/src/shared/app-knowledge.ts index a5f0c6991..afa5c2479 100644 --- a/src/shared/app-knowledge.ts +++ b/src/shared/app-knowledge.ts @@ -105,7 +105,7 @@ The pill follows the worst card. It says Starting or Restarting, in amber, while At least one provider always stays on, and a provider cannot be turned off while anything of it is running: its sessions, its cloud agents, a review, a sign-in, a Sentinel check or analysis, or an Insights report. The row then says the provider is in use and how many things are using it; close them and switch it off again. A provider that is off starts nowhere. Its saved configs say why instead of launching, and a tab that was restored or restarted for it reads Not started, names the provider and points at Settings, Accounts. The same holds when a Claude Code launch on an account is waiting for a sign-in refresh or for the check of the project settings: it asks again when the wait ends, and if its provider is off by then, or the app cannot read whether it is on, nothing starts and the tab says why. A Restart or Switch Account whose launch is refused after it waited says why in the tab before its session ends. The tab and its conversation are kept: turn the provider back on, then Restart the tab. With Claude Code off, Insights runs for Codex accounts only, Ask Conductor runs on Codex, Cloud Agents runs Codex agents only, and Terminal only configs still run. The Feature Guide and its tour show the cards for the assistants you use: with Codex alone, the cards for features that need Claude Code (Dynamic Workflows and Multiple Accounts) and Code review are not shown, and with Claude Code alone, Code review is not shown, since it needs both. The Cloud Agents card, under Integrations, is shown for either assistant; with Codex alone it describes Codex agents only. Tips are not filtered by assistant: a tip about something only one assistant has carries that assistant's mark, Claude Code's or Codex's, beside its title on the tip card and in the sidebar's tip row, and a tip about both, or about the app itself, carries none. -On Windows the installer opens with a Welcome page, then asks for the Data folder (sessions, logs and configuration data) and the Resources folder (shared insights, screenshots, skills and scripts), then whether to install for you or for everyone, and where. On an upgrade, every one of those pages comes up with the earlier install's choices already selected. Updates from inside the app run the same pages and keep the folders you chose. If your own copy of AI Code Conductor is still running from the folder being installed, the installer asks it to close and leaves other users' copies and the session helper alone; while the app shows its save dialog, the installer waits, so answer the dialog and then choose Retry. Uninstalling removes the program but leaves both folders; if your resources folder holds a CONFIG folder, the uninstaller asks whether to remove that too. It also ends the terminals and sessions the session helper still holds for you, and removes the session helper's own folder, with its copies and records; an update leaves that folder in place. Every page of the installer and the uninstaller has the same light look, with the brand in the header and the side art. +On Windows the installer opens with a Welcome page, then asks for the Data folder (sessions, logs and configuration data) and the Resources folder (shared insights, screenshots, skills and scripts), then whether to install for you or for everyone, and where. On an upgrade, every one of those pages comes up with the earlier install's choices already selected. Updates from inside the app run the same pages and keep the folders you chose. If your own copy of AI Code Conductor is still running from the folder being installed, the installer asks it to close and leaves other users' copies and the session helper alone; while the app shows its save dialog, the installer waits, so answer the dialog, and choose Retry if the installer's box is showing. Uninstalling removes the program but leaves both folders; if your resources folder holds a CONFIG folder, the uninstaller asks whether to remove that too. It also ends the terminals and sessions the session helper still holds for you, and removes the session helper's own folder, with its copies and records; an update leaves that folder in place. Every page of the installer and the uninstaller has the same light look, with the brand in the header and the side art. Setup's first step saves two folders: the data directory and the resources directory. Each must be a full path, for example one with a drive letter or a network share (\\\\server\\share) on Windows, or one starting with / on macOS and Linux. If either folder is empty, is not a full path, cannot be created or cannot be saved, setup stays on that step and says which folder could not be saved. Windows saves the folders in the registry; macOS and Linux save them in the app's settings file in your home folder. Choose another folder and press Continue again. Continue, the folder fields and Browse wait while the folders are being saved. A fresh install asks Which assistants will you use? during setup (Claude Code, Codex, or both), and you can change the answer later in Settings, Accounts. If Claude Code is not installed, the first setup screen says so and lists its install commands, Anthropic's native installer first and npm second, each with Run it for me and Copy: Run it for me runs the command in a terminal on that screen once you confirm it, and setup checks again when it ends and carries on as soon as Claude Code is found. That screen also offers Use Codex only, which turns Claude Code off and Codex on. Choosing Codex during setup leads to the Set up Codex page. It checks for the Codex command line tool, offers its install or update commands the same way (OpenAI's installer first, then npm, and Homebrew on a Mac; Run it for me types the command into a visible terminal tab after you confirm it, and the page checks again when it ends), and then signs you in to a new Codex account.`, }, diff --git a/tests/unit/shared/app-knowledge.test.ts b/tests/unit/shared/app-knowledge.test.ts index 043070f63..4784da7d6 100644 --- a/tests/unit/shared/app-knowledge.test.ts +++ b/tests/unit/shared/app-knowledge.test.ts @@ -2164,7 +2164,7 @@ describe('the 2.1.3-beta.8 sweep', () => { it('the installer paragraph says the app check closes only your own copy and waits at its save dialog (#720)', () => { const p = body('providers') expect(p).toContain('If your own copy of AI Code Conductor is still running from the folder being installed, the installer asks it to close') - expect(p).toContain('while the app shows its save dialog, the installer waits, so answer the dialog and then choose Retry') + expect(p).toContain("while the app shows its save dialog, the installer waits, so answer the dialog, and choose Retry if the installer's box is showing") }) it('the Machines section says an update with Save sessions keeps held terminals on Windows, and what still ends them', () => { @@ -2260,7 +2260,7 @@ describe('the 2.1.3-beta.8 sweep', () => { "the vision browser no longer keeps the app's files open after the app ends", 'closed on every way the app exits, including an update install', 'the installer now closes only your own copy of AI Code Conductor that runs from the folder being installed', - 'while the app shows its save dialog the installer waits for you instead of ending it', + 'In a normal install it asks the app to close first, and while the app shows its save dialog the installer waits for you instead of ending it', ]) expect(all).toContain(said) for (const text of [entry.highlights ?? '', ...entry.warnings!, ...entry.changes.map((c) => c.description)]) expect(text, text.slice(0, 40)).not.toMatch(/—/) // #710 measured no CPU figure, so no line claims one.