Go module with the task tree screen; worktrees on and measured; Go installed

README.md

@@ -26,10 +26,23 @@ Nothing else.
 - Paperclip server running locally on `http://127.0.0.1:3100` (it is; 685 endpoints).
 - `PAPERCLIP_BOARD_KEY` in the environment — the **user** key. The terminal program uses
   this one. An agent key cannot write outside a heartbeat run.
-- Go toolchain — **not installed yet**; add `go` to `/etc/nixos/configuration.nix` before
-  Milestone 2. See `docs/ENVIRONMENT-FACTS.md`.
+- Go toolchain — **now installed** (`go1.26.5`, from `nix profile`). The NixOS config change
+  that makes it permanent is staged in `/etc/nixos/configuration.nix` and needs one
+  `sudo nixos-rebuild switch`. See `docs/ENVIRONMENT-FACTS.md`.
 - Pi, which is already the worker adapter on your Paperclip agent.
 
+## Running the terminal program
+
+```bash
+cd tui
+go run . -project spike-2026-11-10        # full-screen task tree
+go run . -project spike-2026-11-10 -dump  # same data as plain text, no interface
+```
+
+The project can be an id or its url key. Keys inside the program: arrows or Tab and
+Shift-Tab move, `r` re-reads from Paperclip, `q` quits. A bare Esc is left free, because in
+TUIOS it has to close a box.
+
 ## Rules for this project
 
 - No interface work before a real task has run end to end.