Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,30 @@ 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 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.

### Added
- 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.
- 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 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.
- 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

### Warnings
Expand Down Expand Up @@ -2002,6 +2026,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
Expand Down
25 changes: 12 additions & 13 deletions CONTEXT.d/2026-11-17-probe-p16-hook-process-cost.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 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.
Expand Down
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -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",
Expand Down
7 changes: 4 additions & 3 deletions src/main/vision-manager.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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])

Expand Down
21 changes: 21 additions & 0 deletions src/renderer/changelog.ts
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,27 @@ 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 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 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: [
{ 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 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.' },
{ 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. 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.' },
],
},
{
version: '2.1.3-beta.7',
date: '2026-11-17',
Expand Down
2 changes: 1 addition & 1 deletion src/renderer/components/SettingsPage.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -623,7 +623,7 @@ export default function SettingsPage({ initialTab, onNavigateToSessions, onUpdat
/>
<span>
Plain terminals through the session helper
<span className="block text-[10px] text-[var(--text-muted)]">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.</span>
<span className="block text-[10px] text-[var(--text-muted)]">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.</span>
</span>
</label>
{/* 2.1.3-beta.7 (plan section A3): agent sessions through the session helper, a preview. */}
Expand Down
18 changes: 18 additions & 0 deletions src/renderer/tips-library.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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 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 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',
},
},
},
]
Loading
Loading