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>/:

goal.md
plan.toon
state.toon
standards.md

The repo-local task config lives at:

.agent/controller-loop/task.toon

Commands

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:

nix develop -c cargo test
nix develop -c cargo run