sam/paperclip-harness
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

TUIOS runbook: the environment is not tmux, and how sessions start on .13/.27/.51

Browse Source 
The handover named TUIOS but never said plainly that it is not tmux, how a session is
created on each machine, that workspaces vanish when empty and renumber, that TUIOS keeps
h/j/k/l in window mode, or how to drive a pane from a script. All of it is now in
docs/TUIOS-RUNBOOK.md, referenced first in AGENTS.md and README.
This commit is contained in:
sam
2026-11-10 11:31:10 +11:00
parent d89479bcf1
commit 4e2eb5d2dd
4 changed files with 113 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
AGENTS.md
View File

@@ -4,6 +4,16 @@ You are picking up a project that is starting fresh, after two earlier attempts
closed. Read this file first, then `HANDOVER.md`, then `docs/PLAN.md`. Do not read the old
project unless this file tells you to.
## Read this before anything else: the environment is TUIOS, not tmux
This system runs inside **TUIOS**, a terminal multiplexer with workspaces and panes. There
is no tmux here. `docs/TUIOS-RUNBOOK.md` explains it, including how to start a session from
`.27`, `.13` or `.51`, and the four rules that have already cost us two days: workspaces
disappear when empty and renumber, TUIOS keeps `h j k l` in window mode, a resize arrives
as a normal terminal resize, and a page must keep one pane that never exits.
Do not write a design that assumes tmux, a single fullscreen app, or a fixed window size.
## What we are building
One small Go terminal program with four screens, sitting on top of Paperclip, inside