Files
obsidian-vault/010 inbox/TUIOS Coding Harness.md

2.0 KiB

proposed_folder, proposed_toc, proposed_tags, confidence, approved, proposed_for
proposed_folder proposed_toc proposed_tags confidence approved proposed_for
300 areas/350 AI Pi Coding Agent 100 Table of Contents/Areas.md → AI & Coding Agent
project
go
agents
system
coding
tuios
0.59 false d95b860095a7

TUIOS Coding Harness

What it is. A terminal "office" that runs inside TUIOS: a board of tasks, three worker agents in their own panes, and a person who is only interrupted when a decision is needed.

Why it exists. To stop being the person in the middle. Instead of reading agent output and telling each agent what to do next, the work is a list of cards. Workers take cards. A green test run merges. The person handles exceptions.

How it is put together.

  • TUIOS (0.12.1) supplies panes, six named workspaces, task cards with an atomic claim, worktrees, checkpoints and shipping. Most of the system was already there.
  • The board is a Go program written with Bubble Tea and Lip Gloss — the same toolkit TUIOS uses. It reads the task cards and takes every key.
  • The agents are Pi, one per worker pane, each in its own git worktree.
  • Gitea holds the code.

The one design rule. One thing owns each piece of state: the task queue belongs to the TUIOS daemon, code belongs to git, decisions belong to the person.

What went wrong on the way, and is worth knowing. TUIOS can draw rich panels from markup (TML). They render beautifully in a browser and take no keyboard input there, which made every button built on them dead. A plain terminal program has none of that problem. That single discovery turned a month of dead ends into one program.

What it shows. Agent orchestration, terminal UI work in Go, task governance, and the discipline of removing components: an early plan had a custom board, a lock, a messenger and a scheduler. TUIOS already had all four.

Status. The board, the six screens and the repair path work on three machines. The gate, the review screen and the first real project are next.