---
proposed_folder: 300 areas/350 AI Pi Coding Agent
proposed_toc: "100 Table of Contents/Areas.md → AI & Coding Agent"
proposed_tags:
  - project
  - go
  - agents
  - system
  - coding
  - tuios
confidence: 0.59
approved: false
proposed_for: 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.