Interactive 4-Split Terminal UI (TUI)
The AIX 4-Split TUI (aix tui) provides a cockpit experience in the terminal, rendering task progress, streaming tokens, tool executions, and file diffs simultaneously across four responsive panes.
1. 4-Split Layout Architecture
┌──────────────────────────────────────┬──────────────────────────────────────┐
│ Panel 1: Autonomous SWE Loop Graph │ Panel 2: Streaming Agent Discourse │
│ • Task Breakdown & Subtasks │ • CoT Reasoning Trace │
│ • Verification Gates Status │ • Multi-Turn Dialogue │
│ • CircuitBreaker State (Armed) │ • Citations & File References │
├──────────────────────────────────────┼──────────────────────────────────────┤
│ Panel 3: Sandboxed Tool Runner │ Panel 4: Live Unified Diff Viewer │
│ • Real-time Shell Stderr / Stdout │ • Color-coded Git Hunk Changes │
│ • pytest / npm test Progress Bar │ • Syntax Highlighting │
│ • MCP Tool Execution Invocations │ • Side-by-Side Before/After │
└──────────────────────────────────────┴──────────────────────────────────────┘2. Keyboard Shortcuts & Navigation
| Key Combination | Action | Description |
|---|---|---|
Tab / Shift+Tab | Cycle Focused Panel | Move focus clockwise or counter-clockwise through Panels 1–4 |
1 / 2 / 3 / 4 | Direct Panel Focus | Immediately jump focus to the numbered panel |
Space | Pause / Resume Loop | Temporarily suspend execution to inspect diff or tool output |
Enter | Approve Pending Action | Human-in-the-Loop approval for pending file write or shell command |
d | Deny Pending Action | Reject proposed tool call and prompt agent for alternative approach |
f | Fullscreen Active Panel | Toggle current focused panel between split view and full screen |
j / k (or ↑ / ↓) | Scroll Focused View | Scroll vertically through logs, reasoning tokens, or diff lines |
g / G | Jump to Top / Bottom | Fast scroll to the beginning or end of output in focused panel |
Ctrl+C | Abort Current Tool | Gracefully interrupt running tool execution without killing session |
Ctrl+Q | Quit TUI | Exit TUI and persist session checkpoint to ~/.aix/sessions/ |
3. Session Recovery & Detach
Sessions started in aix tui can be detached and re-attached without losing state:
# Detach with Ctrl+D, then re-attach later:
$ aix tui --session sn-sess-8f3a9d
# Resume the most recent active session:
$ aix tui --resume