Hint Mode

Vimium-style keyboard navigation for links and file paths in the visible terminal viewport. Otty assigns each detected target a one- or two-letter label; type the label to open that target without using the mouse.

Activating

Hint Mode does not have a default shortcut. Start it from Shell → Open Link (Hint Mode), find Open Link (Hint Mode) in the Command Palette, or assign it a shortcut under Settings → Key Bindings.

For example, to bind ⌘⇧J in config.toml:

keybind = cmd+shift+j=toggle_hint_mode

After entering Hint Mode:

Goal	Action
Open a target	Type its label
Copy a target	Hold Shift on the keystroke that selects it
Cancel	Press Esc

For a two-letter label, type the first letter normally, then hold Shift while typing the final letter to copy the resolved URL or absolute path. For a one-letter label, use Shift with that letter. The copied value can then be pasted with ⌘V.

Hint Mode does not currently provide separate shortcuts for copying or revealing a target, and it cannot insert the selected text directly into the terminal prompt.

What's hinted

• File paths detected by Files and Links, including absolute, tilde, and relative paths
• URLs, including OSC 8 hyperlinks

Only targets in the visible viewport are included. Arbitrary words, Git commit hashes, bare IP addresses, and custom regular expressions are not currently supported.

Customising

The shortcut used to enter Hint Mode is configurable, but match types and actions are not yet configurable.

Differences from ⌘click

⌘click works on one target — the one under the cursor. Hint mode is faster when you have several targets visible and don't want to mouse over each.

See also

• Files and Links — what's clickable.
• Vi Mode — keyboard selection (complementary).