The Terminal UI (TUI)
The TUI is a rich, vim-style interface for exploring your decision graph without leaving the terminal.
$ deciduous tui
[SCREENSHOT: tui-overview.png]
The TUI main screen with timeline list and detail panel
Layout
The TUI has two main areas:
- Left: Timeline list of nodes
- Right: Detail panel for the selected node
Press Enter to toggle the detail panel open/closed.
Navigation
| Key | Action |
|---|---|
| j / k | Move down / up |
| gg | Jump to top |
| G | Jump to bottom |
| Ctrl+d / Ctrl+u | Page down / up |
| Enter | Toggle detail panel |
| q | Quit |
Filtering & Search
| Key | Action |
|---|---|
| / | Search by title |
| f | Cycle through type filters (goal, decision, action...) |
| b | Cycle through branch filters |
| B | Fuzzy branch search |
| R | Toggle sort order (newest/oldest first) |
| Ctrl+c | Clear all filters |
[SCREENSHOT: tui-search.png]
The TUI with search active, filtering nodes containing "auth"
File Operations
The TUI can jump directly to files associated with nodes:
| Key | Action |
|---|---|
| o | Open associated files in $EDITOR |
| O | View commit details (if node has linked commit) |
| F | Toggle file browser in detail panel |
| n / N | Next / previous file (when in file browser) |
| p | Preview file with syntax highlighting |
| d | Show file diff with syntax highlighting |
[SCREENSHOT: tui-file-preview.png]
The TUI showing syntax-highlighted file preview
The Detail Panel
When you press Enter on a node, the detail panel shows:
- Node type and confidence score (color-coded)
- Full title and description
- User prompt (if captured with
-p) - Associated files
- Linked git commit
- Incoming and outgoing edges with rationales
[SCREENSHOT: tui-detail-panel.png]
The detail panel showing a decision node with connections and prompt
Other Commands
| Key | Action |
|---|---|
| s | Show goal story (hierarchy from root) |
| r | Refresh graph from database |
| ? | Show help |
Auto-Refresh
The TUI watches the database file and auto-refreshes when it changes. If you add nodes in another terminal, they'll appear automatically.
Specifying Database Path
By default, the TUI auto-discovers the database. To specify a different path:
$ deciduous tui -d /path/to/.deciduous/deciduous.db