Interactive Mode - Documentation

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
`/start`	Start workflow with current template
`/templates`	Select and configure workflow templates
`/login`	Authenticate with AI providers
`/logout`	Sign out of AI providers
`/import`	Import templates from GitHub (`owner/repo`) or local path
`/export`	Show imports folder location
`/exit`	Exit the application

Keyboard Shortcuts

The main workflow monitoring screen.

Key	Action
`↑/↓`	Navigate timeline
`Enter`	Expand agent / Open log viewer
`Space`	Toggle expand sub-agents
`Tab`	Toggle timeline panel
`H`	Open history view
`P`	Pause workflow
`R`	Return to controller (if available)
`Ctrl+S`	Skip current agent/prompts
`Shift+Tab`	Toggle autonomous mode
`→`	Focus prompt input
`Escape`	Show stop confirmation

The starting screen where you enter commands.

Key	Action
`Enter`	Submit command
`↑/↓`	Navigate autocomplete
`Tab`	Complete selected command
`Escape`	Close autocomplete

When the input field is focused.

Key	Action
`Enter`	Submit input / Confirm chained step
`← (at start)`	Exit focus, return to timeline
`Escape`	Exit focus

Confirmation dialogs and popups.

Key	Action
`←/→`	Navigate buttons
`Enter`	Confirm selection
`Y`	Yes/Confirm
`N`	No/Cancel
`Escape`	Cancel/Close
`C`	Continue (checkpoint)
`Q`	Quit (checkpoint)

Shortcuts available in all views.

Key	Action
`Ctrl+T`	Toggle dark/light theme
`Ctrl+C`	Copy selection or exit (press twice to exit)

Track and condition selection screens.

Key	Action
`↑/↓`	Navigate options
`1-9`	Quick select option
`Enter`	Select/submit
`Tab`	Confirm multi-select
`Escape`	Cancel onboarding

History view and log viewer.

Key	Action
`↑/↓`	Navigate entries
`PageUp/PageDown`	Scroll pages
`g`	Go to top
`G (Shift+g)`	Go to bottom
`Enter`	Open log viewer
`H` or `Escape`	Close history
`Ctrl+D`	Clear 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.

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:SS`	Active execution time (only counts while agents run)
Workflow Name	Current workflow
`Awaiting`	Waiting for input (yellow)
`Paused`	Workflow paused (yellow)
`Stopped`	Workflow stopped (red)
`AUTO`	Autonomous 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

Output Window Header

╭─
│  [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.5K`	Token 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
`/start`	`P` = Pause	`↑↓` = Move
`/templates`	`H` = History	`Enter` = Select
`/login`	`R` = Controller	`Space` = Expand
`/logout`	`Ctrl+S` = Skip	`Tab` = Toggle panel
`/import`	`Shift+Tab` = Auto	`Esc` = Stop/Back
`/exit`	`Ctrl+T` = Theme	`→` = Focus input

Chained Prompts: Enter = Confirm step | Type + Enter = Steer Modals: Y/N = Quick select | ←→ = Navigate | Enter = Confirm

​Slash Commands

​Keyboard Shortcuts

​Chained Prompts

​Prompt Line States

​How to Proceed

​Screen Elements

​Telemetry Bar

​Agent Status Icons

​Timeline Display

​Output Window Header

​Toast Notifications

​Quick Reference

Slash Commands

Keyboard Shortcuts

Chained Prompts

Prompt Line States

How to Proceed

Screen Elements

Telemetry Bar

Agent Status Icons

Timeline Display

Output Window Header

Toast Notifications

Quick Reference