Path Completion

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

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

See also

• Variables - variable resolution flow
• Configuration - key binding customization