Interactive TUI (-i)
The interactive mode launches a full-screen terminal explorer with three panes:
a live preview bar, a navigable tree pane, and a help pane that shows
--help output for the currently selected node.

Launch
treemand -i git
treemand -i kubectl
treemand -i docker
The TUI opens as soon as the CLI’s top-level help is read, usually in well under a second, even for CLIs with hundreds of subcommands. The rest is discovered in the background: the status bar shows discoveringβ¦ 37/233, and commands fill in without moving your selection. Everything discovered is cached, so the next run opens complete. If you quit early, the next run picks up where this one stopped.
Workflow
- Navigate β
β/β(orj/k) to browse; cursor never auto-expands - Expand β
βopens a node, press again to enter its children - Pick a command β
Entersets it in the preview bar - Add flags β
fto open the flag picker;Enteron a flag row adds it directly - Fill positionals β
Enteron a positional row opens an input prompt - Copy or run β
Ctrl+Eopens a confirmation modal: copy to clipboard or execute
Key bindings
Navigation
| Keys (arrows) | Keys (vim) | Keys (WASD) | Action |
|---|---|---|---|
β / β | k / j | w / s | Move up / down |
β | l | d | Expand node; enter children on 2nd press |
β | h | a | Collapse node; go to parent on 2nd press |
Shift+β | Shift+L | Shift+D | Expand entire subtree |
Shift+β | Shift+H | Shift+A | Collapse entire subtree |
gg | Jump to top | ||
G | Jump to bottom |
Toggle navigation scheme with Ctrl+S (arrows β vim β WASD).
Tree
| Key | Action |
|---|---|
/ | Fuzzy filter tree nodes (Esc clears, Enter keeps) |
Ctrl+F | Global fuzzy finder over commands, flags, args and help text; Tab indexes undiscovered nodes |
n / N | Next / previous search match |
e / E | Expand all / collapse all |
R | Re-discover / refresh children of selected node |
S | Toggle section headers |
T | Cycle display style |
Building commands
| Key | Action |
|---|---|
Enter | Set command / add flag / fill positional |
f | Open flag picker modal (with search) |
Backspace | Remove last token from preview |
Ctrl+K | Clear the entire preview bar |
Ctrl+E | Copy or execute the assembled command |
View
| Key | Action |
|---|---|
H / Ctrl+P | Toggle help pane |
Tab / Shift+Tab | Cycle pane focus |
d / D | Open docs URL in browser |
? | Show all key bindings (scrollable overlay) |
q / Esc | Quit |
Mouse support
Click any node to select it, click βΆ/βΌ to expand/collapse, and scroll to
navigate. Click the preview bar to focus it for direct text editing.
Navigation schemes
treemand supports three keyboard navigation schemes. Press Ctrl+S to cycle:
| Scheme | Move | Expand | Collapse |
|---|---|---|---|
| Arrows (default) | β/β | β | β |
| Vim | j/k | l | h |
| WASD | w/s | d | a |