Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
docs(tui): name the four things between here and an alternate screen default (#199)
Abdurrahman Fakhrulcd2a547643ba
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.mdindex ef443caf..f2d47e9c 100644--- a/docs/CHANGELOG.md+++ b/docs/CHANGELOG.md@@ -8,7 +8,7 @@ this is the *what*, and it is what Settings → Account → About shows as “Wh**Added**-- `tui` a right-hand side pane for todos, the last diff and changed files+- `tui` a right-hand side pane for todos, the last diff and changed files (#198)- `tui` mouse wheel scrolling and tab clicks, only inside the alternate screen (#197)- `tui` a transcript viewport with a scrollbar, so the alternate screen has a reason (#193)- `tui` an alternate screen behind a flag, with teardown on every exit path (#192)@@ -29,6 +29,10 @@ this is the *what*, and it is what Settings → Account → About shows as “Wh- `api` every route now has a test — 117 of 117- `api` cover 30 more routes, and close the one fs route with no rate limit+**Docs**++- `tui` name the four things between here and an alternate screen default+## 2026-10-30**Added**diff --git a/docs/TUI-RENDERER-PLAN.md b/docs/TUI-RENDERER-PLAN.mdindex bffcdbfd..ee854b89 100644--- a/docs/TUI-RENDERER-PLAN.md+++ b/docs/TUI-RENDERER-PLAN.md@@ -595,7 +595,31 @@ those two, and mouse/scrollbar/splits are additive after M5.| M5 | Alternate screen behind a flag, with teardown | DONE | PR #192; default off; teardown on exit, signals, execve, spawnSync || M6 | Transcript viewport and scrollbar | DONE | PR #193; 2000-line cap, follow mode, PgUp/PgDn/Ctrl+G/End, entrypoint 218 to 196 lines || M7 | Mouse | DONE | SGR 1000/1006 extended mode, wheel scrolls viewport, tab clicks switch session |-| M8 | Split panes, then flip the alt screen default | IN PROGRESS | panel landed, default flip NOT done |+| M8 | Split panes, then flip the alt screen default | PARTIAL | PR #198; right-hand pane for todos, diff, files. Default flip NOT done, blockers in 8.1 |++### 8.1 What remains before the alternate screen can be the default++The pane landed and the flag works, but the default is still `off`. That is not caution about the+renderer, which is now complete. It is that a great deal of the TUI still prints instead of painting:++1. **26 modules print with `console.log`** under `scripts/mso-agent*.mjs` and+ `scripts/mso-agent-cmd-*.mjs` (help, inspect, parity, jobs, todos, files, diff, edit diff,+ approval UI, mentions, skills, status, layout). In the alternate screen a `console.log` writes at+ the cursor, which is inside the frame the loop owns, so the next repaint fights it and a line can+ survive in the wrong row. They need one print sink that appends to the viewport in panel mode and+ prints as before in inline mode.+2. **The composer reserves a fixed number of rows** (`PROMPT_ROWS` in+ `scripts/mso-agent-screen-loop.mjs`), because the composer paints its own rows and cannot report+ them. A wrapped draft taller than that reservation overlaps the panel. The composer has to expose+ its current row count, or the loop has to own the draft rendering.+3. **Prompts and foreground subagents take over the composer area** (`promptApproval` in+ `scripts/mso-agent-approval-ui.mjs`, `runForegroundSubagent`). They are line oriented, so in panel+ mode they would need to be painted into the viewport and answered through the same key path.+4. **Turn-level failures bypass the stream sink**: `renderInteractionFailure` writes directly, so an+ error raised mid-turn would land outside the frame.++Until those four are done, `--altscreen` stays a development switch, and `--oneshot`, non-TTY and CI+remain excluded by `altScreenRequested` regardless of the flag.Adjacent work that landed while this plan was being executed, and belongs to the same goal:`feat/agent-jobs-view` (#183, `/jobs` for background subagents) and `feat/tui-keybinds` (#182,