Terminal Interface
The terminal interface (khaos-tui) provides a full-featured, keyboard-driven interface for Khaos Machine. It runs in your terminal and offers the same project management and analysis capabilities as the web dashboard.
Launching
khaos-tui
Views
The TUI has five main views, navigable with keyboard shortcuts:
| View | Description |
|---|---|
| Projects | Browse and select projects |
| Dashboard | View scenes, characters, locations, and analysis results |
| Analysis | Run and monitor analysis jobs |
| Settings | Configure provider, model, and preferences |
| Import | Import wizard for adding new screenplays |
Import Wizard
The import wizard walks you through adding a new screenplay in 5 steps:
- Select file — browse your filesystem for a screenplay file
- Detect format — auto-detects
.fountain,.fdx,.sbx,.md,.pdf, or.txt - Name project — enter a project name
- Choose location — set the project directory
- Confirm — review and create the project
Keyboard Shortcuts
The TUI uses standard terminal conventions:
- Tab / Shift+Tab — navigate between panels
- Enter — select / confirm
- Escape — go back
- q — quit
- ? — help
When to Use the TUI
The terminal interface is ideal for:
- Remote servers — SSH into a machine and manage projects
- Keyboard-first workflows — no mouse required
- Low-bandwidth — no browser rendering overhead
- Scripting — combine with CLI tools for automated workflows
Logs
TUI activity is logged to ~/.khaos/logs/khaos-tui.log.