[ZacxDev]

What

The operator asked: "Include the bottom bar in the agent terminal view as well as in the render view where it already is so that I can easily switch agents from the terminal view until we need to go back."

The session switcher (internal/ui/switcher.go) now appears on every Terminal view, at the bottom of the column:

• a mirrored window's Terminal view: windows with a Rendered view, terminal-only windows, read-only hosts (composer disabled) and offline hosts (no composer);
• a dispatched claude-code agent's Terminal view (/agents/{name}/terminal).

The bar shows even when the composer is disabled or missing, because switching sessions doesn't depend on being able to send.

How

• ui.AgentTerminalView.Switcher. When there's a composer, the bar is drawn inside it as its last row, as on the Rendered view, but in flow rather than Pinned. When there's no composer, it goes in a box exactly the bar's height. The safe-area inset moves from the key bar or form to the bar.
• mirrorComposer: an in-flow composer that holds the bar now gets relative. Before, only its / menu or suggestion row set that, so the absolutely placed bar would have been positioned against the page instead of the space reserved for it.
• SwitcherCurrent.Back: when you pin without script, the page returns to the Terminal view instead of the session's other view.
• The header pin that terminal-only windows had (TerminalPin) is removed. The bar's pin replaces it, so a page has only one #switcher-pin. The pin route's answer now always carries the bar's rows out of band.
• Opening an agent's Terminal view now records a recent visit, like the mirrored Terminal view and the chat page already do. It is recorded before the switcher is built, so Recent leaves out the page's own session.

Terminal size (hazard 1)

The page only ever sends a size that covers the far side's window, and termsize.Decide on the far side never shrinks a window. So the bar can't shrink the remote tmux window in any case.

To avoid resize churn, the bar is server-rendered at a fixed height and appears in the document before the terminal's script runs. The terminal's first proposed() measurement therefore already has the bar's space taken. The pending-until-whole visibility and switching views in the bar change no layout, so no second resize is sent.

Side effect on desktop: if this browser had previously grown the window to the full page height, the page is now about 3 rows shorter than the window. It shows that window in its scroll area instead of resizing it. Round 1 (Y1): that scroll area now starts at its bottom and goes back there on every redraw, so the prompt and status line (a TUI's last rows) stay on screen. It stays put if the person scrolled away, until they scroll back to the bottom.

The bar steps aside (round 1, Y2, operator decision)

• Keyboard: on the Terminal views and the Rendered view, the bar hides and gives its room back while a text field has focus and the visual viewport is at least 150px shorter than the tallest it has been at this width (<html data-keyboard>). It comes back when the keyboard closes. 150px is smaller than any phone keyboard (≈200–350px) and larger than a browser toolbar collapsing (≈50–100px), so the toolbar doesn't make the bar flicker.
• Very short screen: a CSS media query hides it at max-height: 30rem, so the decision is made before the first paint. This applies to the Terminal views only. The Rendered view's pinned composer reserves a measured height whose first-paint fallback includes the bar, so collapsing the bar with a query there would shift the transcript on load. 30rem (480px) is taller than any landscape phone and shorter than the smallest portrait phone's page.
• The agent chat page's bar is unchanged.

Tests

• Red/green: TestTheMirroredTerminalViewsDrawTheSessionSwitcher (3 cases) and TestAnAgentsTerminalViewDrawsTheSessionSwitcher fail at origin/main b60d5d9 (0 #session-switcher) and pass here.
• TestATerminalViewsSwitcherIsTheColumnsFootAndInPlaceBeforeTheTerminalMeasures checks that the bar comes before the terminal's script, sits in its reserved space with relative, and carries the safe-area inset alone. I broke each of the first two on purpose and saw the test fail with that check's own message.
• e2e at 390×844, for both a mirrored and an agent Terminal view: the bar is visible with the page's session marked current, CLS stays under 0.01, the fake far side received exactly one size, switching views sends no resize, the input stays above the bar with a soft keyboard open, and tapping an entry opens that session. Both tests fail at origin/main.
• pins.spec: a shell window's pin is now found in its bar.

Known limitation

When the Terminal view is opened in the view-swap frame over the Rendered view, pinning in one document doesn't refresh the other document's bar until it reloads.

🤖 Generated with Claude Code

[ZacxDev]

Round 0 (requirements & deletion): proceed to the checklist. Ledger: requirements 9 (unattributed 3) · deletion candidates 2 · no open premises.

D1 — the agent Terminal view's new recordAgentVisit (internal/api/terminal.go:314): no test covers it, and its comment's ordering reason is false (NewSwitcher already leaves the page's own session out of Recent); keep it for the go-back-via-Recent reason and fix the comment, or drop it
D2 — SwitcherCurrent.Back (internal/ui/switcher.go:125, :262): read only by the no-script pin fallback; keeps the old header pin's return to the Terminal view; cheap to keep, safe to delete

[ZacxDev]

Round 1 (nine-axis checklist): 0 🔴, 3 🟡, 4 🟢. No 🔴, so the ladder ends; the 🟡s are fixed un-re-audited or recorded open.

1. (🟡) desktop overflow after the bar shortens the terminal hides the bottom rows (the Claude Code prompt) with the scroll area at the top — pin overflow scroll to the bottom or record the limitation
2. (🟡) the fixed-height bar takes ~1/3 of the terminal on short viewports (landscape / keyboard open) — collapse or hide it, or record it
3. (🟡) add a Go test: a view=switcher pin with a Terminal `back` answers with the hx-swap-oob rows
4. (🟢) terminal-only window loses its pin when the switcher list fails to build
5. (🟢) the term-keys order check in terminal_switcher_test.go passes vacuously when #term-keys is missing