Guide and reference
Addresses and pasted paths
The address field and ⇧⌘G use one grammar. A bare path is local, and a host prefix makes the address remote.
Accepted forms#
| Form | Meaning |
|---|---|
/etc | an absolute path on this Mac |
~ or ~/src | your home, or a path below it, on this Mac |
file:///Users/me/src | a local file URL |
local:/tmp | an explicit path on this Mac |
koan:/srv | an absolute path on the SSH host koan |
koan:~ or koan:~/src | the configured user's home on koan |
koan or koan: | the configured user's home on koan |
:/srv, :~, or : | the named path on the focused pane's current host |
A bare path always refers to this Mac because the parser never tests other hosts to reinterpret it. Remote paths require an SSH alias or the current-host colon form.
Pasted text#
The parser removes edge whitespace, a byte-order mark, zero-width marks, and one matching pair of surrounding quotes. It decodes backslash escapes for a space, quote, or backslash because terminals commonly copy those forms. It does not run a shell or expand variables, command substitutions, or globs.
Multiline text, NUL bytes, unmatched quotes, non-file URLs, malformed host names, and relative remote paths are refused. The refusal leaves the pane at its current location.
Missing pasted paths#
The exact path is checked first. When it is absent, pālana may remove one trailing prose mark such as a period, comma, colon, semicolon, exclamation mark, or closing bracket, and it accepts that correction only when the result exists.
If the corrected path is absent, pālana may point at the longest existing directory prefix and report the remaining suffix. Recovery stays on the host named by the address, and the pane never lands at the filesystem root unless the address requested it.