The TUI is your command center for running and monitoring workflows. Launch it by running codemachine without subcommands. From here you can start workflows, monitor agents, and control execution.
Slash Commands Type / to see autocomplete suggestions. Use ↑↓ to navigate and Tab to complete.
Command Description /startStart workflow with current template /templatesSelect and configure workflow templates /loginAuthenticate with AI providers /logoutSign out of AI providers /importImport templates from GitHub (owner/repo) or local path /exportShow imports folder location /exitExit the application
Keyboard Shortcuts
The main workflow monitoring screen. Key Action ↑/↓Navigate timeline EnterExpand agent / Open log viewer SpaceToggle expand sub-agents TabToggle timeline panel HOpen history view PPause workflow RReturn to controller (if available) Ctrl+SSkip current agent/prompts Shift+TabToggle autonomous mode →Focus prompt input EscapeShow stop confirmation
The starting screen where you enter commands. Key Action EnterSubmit command ↑/↓Navigate autocomplete TabComplete selected command EscapeClose autocomplete
When the input field is focused. Key Action EnterSubmit input / Confirm chained step ← (at start)Exit focus, return to timeline EscapeExit focus
Confirmation dialogs and popups. Key Action ←/→Navigate buttons EnterConfirm selection YYes/Confirm NNo/Cancel EscapeCancel/Close CContinue (checkpoint) QQuit (checkpoint)
Shortcuts available in all views. Key Action Ctrl+TToggle dark/light theme Ctrl+CCopy selection or exit (press twice to exit)
Track and condition selection screens. Key Action ↑/↓Navigate options 1-9Quick select option EnterSelect/submit TabConfirm multi-select EscapeCancel onboarding
History view and log viewer. Key Action ↑/↓Navigate entries PageUp/PageDownScroll pages gGo to top G (Shift+g)Go to bottom EnterOpen log viewer H or EscapeClose history Ctrl+DClear history
Chained Prompts Chained prompts are multi-step workflows where you confirm each step before proceeding.
Prompt Line States Symbol State Meaning ·Disabled Workflow not running ❯Passive Agent working (watch only) ‖Active (paused) Waiting for your input ❯Chained Ready for next step confirmation
How to Proceed
See the prompt
The prompt shows: Next: "Validation" (2/4) with hint Step 2/4: Validation
Confirm or steer
Press Enter with empty input → Confirmation modal appears
Or type a message then Enter → Sends steering input (no confirmation needed)
Confirm the modal
Press Y or select “Yes, Proceed” to continue to the next step.
Confirmation Modal Example
▲ Confirm Step Transition Are you sure you want to proceed to step 2/4? Validation - Validate the output You cannot return to the previous step once you proceed. [Yes, Proceed] [Cancel]
Press Ctrl+S to skip all remaining chained prompts.
Screen Elements Telemetry Bar The bottom bar shows workflow status:
Runtime: 00:05:23 My Workflow • Awaiting • AUTO
Element Description Runtime: HH:MM:SSActive execution time (only counts while agents run) Workflow Name Current workflow AwaitingWaiting for input (yellow) PausedWorkflow paused (yellow) StoppedWorkflow stopped (red) AUTOAutonomous mode enabled (blue)
Agent Status Icons Icon Status Color ◐◓◑◒Running Blue (animated) ○Pending White ●Completed Green ✗Failed Red ●Skipped Gray ⟳Retrying White ◉Awaiting Yellow ◈Delegated Blue ॥Paused Yellow
Timeline Display Workflow Pipeline (5 items) > ● Agent Name (claude) • 00:01:23 ▶ Sub-agents: 3 done, 1 running ○ Next Agent (gpt-4) • pending
Symbol Meaning >Selected agent ▶Collapsed sub-agents (press Space or Enter to expand) ▼Expanded sub-agents
╭─ │ [emoji] Agent Name claude claude-3-5-sonnet ● running │ ↳ Analyzing code structure... context: 12.5K ╰─
Element Description Face/emoji Agent character Agent Name Current agent (bold) Engine AI provider (e.g., claude) Model Specific model Status Running state with icon Phrase Current activity (animated) context: 12.5KToken usage
Token display format: Under 1000 shows exact number (123), 1K-999K shows decimal (1.2K), 1M+ shows millions (1.2M).
Toast Notifications Appear in the top-right corner.
Variant Icon Color Success ✓Green Error ✗Red Info ℹBlue Warning ▲Yellow
Quick Reference Commands Workflow Navigation /startP = Pause↑↓ = Move/templatesH = HistoryEnter = Select/loginR = ControllerSpace = Expand/logoutCtrl+S = SkipTab = Toggle panel/importShift+Tab = AutoEsc = Stop/Back/exitCtrl+T = Theme→ = Focus input
Chained Prompts: Enter = Confirm step | Type + Enter = SteerModals: Y/N = Quick select | ←→ = Navigate | Enter = Confirm
