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.

treemand TUI demo

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

  1. Navigate β€” ↓/↑ (or j/k) to browse; cursor never auto-expands
  2. Expand β€” β†’ opens a node, press again to enter its children
  3. Pick a command β€” Enter sets it in the preview bar
  4. Add flags β€” f to open the flag picker; Enter on a flag row adds it directly
  5. Fill positionals β€” Enter on a positional row opens an input prompt
  6. Copy or run β€” Ctrl+E opens a confirmation modal: copy to clipboard or execute

Key bindings

Keys (arrows)Keys (vim)Keys (WASD)Action
↑ / ↓k / jw / sMove up / down
β†’ldExpand node; enter children on 2nd press
←haCollapse node; go to parent on 2nd press
Shift+β†’Shift+LShift+DExpand entire subtree
Shift+←Shift+HShift+ACollapse entire subtree
ggJump to top
GJump to bottom

Toggle navigation scheme with Ctrl+S (arrows β†’ vim β†’ WASD).

Tree

KeyAction
/Fuzzy filter tree nodes (Esc clears, Enter keeps)
Ctrl+FGlobal fuzzy finder over commands, flags, args and help text; Tab indexes undiscovered nodes
n / NNext / previous search match
e / EExpand all / collapse all
RRe-discover / refresh children of selected node
SToggle section headers
TCycle display style

Building commands

KeyAction
EnterSet command / add flag / fill positional
fOpen flag picker modal (with search)
BackspaceRemove last token from preview
Ctrl+KClear the entire preview bar
Ctrl+ECopy or execute the assembled command

View

KeyAction
H / Ctrl+PToggle help pane
Tab / Shift+TabCycle pane focus
d / DOpen docs URL in browser
?Show all key bindings (scrollable overlay)
q / EscQuit

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.

treemand supports three keyboard navigation schemes. Press Ctrl+S to cycle:

SchemeMoveExpandCollapse
Arrows (default)↑/↓→←
Vimj/klh
WASDw/sda