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

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
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