feat: ui

README.md

@@ -0,0 +1,57 @@
+# `codex-controller-loop`
+
+Rust TUI-first autonomous controller with TOON-backed machine state.
+
+## Product Shape
+
+`codex-controller-loop` now targets a single full-screen terminal experience:
+
+- center session stream for planning and execution events
+- persistent plan board on the right
+- bottom composer for planning replies or execution commands
+- Codex-backed planning and Codex-backed per-step execution
+
+The controller has a hard two-phase model:
+
+1. Planning
+   - user can provide the goal or answer Codex follow-up questions
+2. Executing
+   - controller runs autonomously
+   - user can only pause, resume, stop, inspect status, or update the goal
+
+## Storage
+
+Controller-local artifacts live under `.agent/controllers/<id>/`:
+
+```text
+goal.md
+plan.toon
+state.toon
+standards.md
+```
+
+The repo-local task config lives at:
+
+```text
+.agent/controller-loop/task.toon
+```
+
+## Commands
+
+```bash
+codex-controller-loop
+codex-controller-loop init --task-id controller-loop
+codex-controller-loop status
+codex-controller-loop run
+```
+
+`codex-controller-loop` defaults to the TUI.
+
+## Build
+
+Use Nix or Cargo:
+
+```bash
+nix develop -c cargo test
+nix develop -c cargo run
+```