Farhelm GPUI migration · 2026-11-14

Milestone M1: foundations

TL;DR: The foundations, the agent test stack and a thin first slice of the new app are on main. A fresh review of the whole new GUI found nothing off the rails and growth proportionate to what landed; it found the foundations shaped around their one first user (sessions), so a short list gets fixed before the parallel area work starts. Nothing here needs an answer from you; one old question is still open at the end.

What M1 delivered

Screenshots: the new app beside the old one

Each scene shows the new app (left) next to the old app's reference (right), light and dark, at the wide size (1600×1000). Click any image for full size. These are 34 of the batch's images: the full batch has 76 new-app captures (the 8 app scenes at two sizes and both themes, plus 22 foundation goldens) and 434 old-app reference images, kept privately.

What visibly differs today (expected: those parts are later areas' work):

Session list, running session open

The main window over a fleet of four (running, waiting, idle, exited), the running Fixture 1 open with its terminal attached. Old app: its running session open.

New app, Session list, running session open, light theme, wide
New app · light
Old app, Session list, running session open, light theme, wide
Old app · light
New app, Session list, running session open, dark theme, wide
New app · dark
Old app, Session list, running session open, dark theme, wide
Old app · dark

Waiting session open

The waiting Fixture 2 open, its terminal showing the question it waits on.

New app, Waiting session open, light theme, wide
New app · light
Old app, Waiting session open, light theme, wide
Old app · light
New app, Waiting session open, dark theme, wide
New app · dark
Old app, Waiting session open, dark theme, wide
Old app · dark

Idle session open

The idle Fixture 3 open.

New app, Idle session open, light theme, wide
New app · light
Old app, Idle session open, light theme, wide
Old app · light
New app, Idle session open, dark theme, wide
New app · dark
Old app, Idle session open, dark theme, wide
Old app · dark

Exited session open

The exited Fixture 4 open, its terminal on its last screen.

New app, Exited session open, light theme, wide
New app · light
Old app, Exited session open, light theme, wide
Old app · light
New app, Exited session open, dark theme, wide
New app · dark
Old app, Exited session open, dark theme, wide
Old app · dark

Row menu

The idle Fixture 3's row menu, opened from its actions button.

New app, Row menu, light theme, wide
New app · light
Old app, Row menu, light theme, wide
Old app · light
New app, Row menu, dark theme, wide
New app · dark
Old app, Row menu, dark theme, wide
Old app · dark

Delete question from a row

Delete chosen from the waiting Fixture 2's row menu: the question asked beside its actions button.

New app, Delete question from a row, light theme, wide
New app · light
Old app, Delete question from a row, light theme, wide
Old app · light
New app, Delete question from a row, dark theme, wide
New app · dark
Old app, Delete question from a row, dark theme, wide
Old app · dark

Rename dialog

Rename chosen from the idle Fixture 3's row menu (after Cancel on the Delete question): the rename dialog.

New app, Rename dialog, light theme, wide
New app · light
Old app, Rename dialog, light theme, wide
Old app · light
New app, Rename dialog, dark theme, wide
New app · dark
Old app, Rename dialog, dark theme, wide
Old app · dark

Empty fleet

The main window over an empty fleet.

New app, Empty fleet, light theme, wide
New app · light
Old app, Empty fleet, light theme, wide
Old app · light
New app, Empty fleet, dark theme, wide
New app · dark
Old app, Empty fleet, dark theme, wide
Old app · dark

At the narrow size (900×700)

The first scene again at the narrow size, light theme only. The new app keeps the same split with the terminal filling what is left; the old app's terminal wraps and its toolbar runs off the right edge.

New app, Session list, running session open, light theme, narrow
New app · light
Old app, Session list, running session open, light theme, narrow
Old app · light

Speed (test Mac, a VM with a fixed 60 Hz display)

The milestone review, in short

Verdict: fix a short list before the areas start; not a rethink. Nothing goes around a foundation, no old bug class came back, and the special cases are all justified by SPEC or the platform.

What is being fixed, and who does it:

  1. The rule that keeps areas out of the foundations was too strict. Replayed over M1's own work, it would have refused most ordinary wiring changes (adding a screen to the main window, a new button option, a test screenshot). It now refuses only changes to the modules that carry rules (focus, overlays, questions, the channel and store, the clock); other shared files are allowed when they follow the existing pattern, and the per-change review checks that. I am landing this before any area starts.
  2. The end-to-end smoke test would run its tenth step second (steps sorted as text), and every area's steps would share the same three demo sessions. Fixed before areas start.
  3. The editing pieces the next areas need do not exist yet. Saving only works for sessions (not settings, hosts, templates or a new launch); a question can only have two answers, while SPEC's template and recipe editors ask “Keep editing / Discard / Save”; each text field's draft handling is written by hand; there is no dropdown, checkbox, radio, toggle, growing multi-line box or busy look for Save. A second, small foundations goal builds these while the terminal and sidebar areas run, so three areas do not each invent their own. It also adds the physical-key shortcut table (number keys and text size must work from a focused terminal) and splits the foundations' test files.
  4. The parity checklists did not match the revised area list. Split and renamed.

Kept as is: the two GPUI patches with no user yet (clipboard attachments for paste-as-upload, Linux second-launch activation) stay until a GPUI upgrade, when they are dropped rather than ported if still unused. The notice center's real shape (bell, notices panel, approval cards, chimes) is built by the approvals area in M3.

Size

Next

Area goals are being written now: terminal and sidebar-and-session-view first (two at once), the second foundations goal alongside them; then launcher and settings-and-hosts; then templates-and-quick-launch and desktop integration; approvals and other dialogs last (M3). You get a separate notification when they are ready to start.

Still open (nothing waits on it)

Terminal block characters at non-default text sizes. Stacked full blocks (progress bars, terminal graphs) show a faint stripe between rows at most sizes other than 14 pt, because the font's block glyph is shorter than the cell. The old app very likely did the same. Options:

Recommendation (a); default until you answer (b).