58 lines
1.1 KiB
Markdown
58 lines
1.1 KiB
Markdown
# `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
|
|
```
|