# `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
```