Executor
The Executor is the role that runs Aiur, assigns tickets, and tracks progress.
Who drives
| Driver | How the role works |
|---|---|
| Human | Launches Aiur, reads the TUI or Dashboard, and answers agent Commands. |
| Designated agent | Drives the same run through the CLI and Dashboard on the human's behalf. |
Even when a human drives, a second agent is recommended for log analysis, snag detection, blockers, and background issues.
Executor surfaces
| Surface | Purpose |
|---|---|
| TUI | Foreground fleet and live chats. |
| CLI | Agent-oriented run control; parity with interactive surfaces is the design target. |
| GUI | Browser fleet, Commands, Build Orders, analytics, and meters. |
| Stream Deck | Physical or browser controls and event logs. |
| Message Bus | Agent coordination, Commands, blockers, and attentions. |
Keeping tickets moving
| Responsibility | Operator action |
|---|---|
| Supply work | Apply agent:todo to dispatchable tickets. |
| Watch flow | Read How a ticket flows. |
| Resolve snags | Answer or defer Commands. |
| Protect capacity | Pause work or change the live agent cap. |
| Finish safely | Keep CI, review, and merge gates moving without self-merging agent work. |
