← Home Docs
GitHub wiki

Path Completion

While resolving a variable, press Tab to complete filesystem paths inline. This works for prompt-only vars and while filtering shell-generated choices.

How it works

/us<Tab>              -> /usr/
$USE<Tab>             -> $USER      
$HOM<Tab>             -> $HOME/
  • One match: completes immediately
  • Multiple matches: expands to the longest shared prefix and shows candidates inline below the input
  • No matches: Tab falls through to its normal behavior (copies the highlighted picker option into the input)

Behavior details

  • Directories get a trailing /
  • Spaces and shell-sensitive characters are automatically escaped
  • Environment variable roots (like $HOME/...) are preserved in the typed value - only the path portion after the variable is expanded
  • Empty path segments list directory entries

When Tab does what

ContextTab behavior
Input looks like a path (/, ./, ~/, $VAR/)Filesystem completion
Input doesn’t look like a pathCopies highlighted picker option into input
No picker options visible (prompt-only)Filesystem completion if path-like, otherwise no-op

See also