URL Scheme

Otty registers the otty:// URL scheme, so any link — a bookmark, a menu-bar launcher, a script, or text printed into the terminal — can bring Otty forward and focus a specific window, tab, or pane.

open otty://pane/$OTTY_PANE_ID     # focus the pane this shell is running in
open otty://window/current         # bring Otty's active window forward
open otty://tab/t_19f6a…           # jump to a tab by id

The links resolve from anywhere the system can open a URL — open otty://…, a browser, a note, a Raycast/Alfred action — and they are also clickable when printed inside a pane.

Targets

A URL is otty://<kind>/<selector>. The selector after the kind is exactly the one otty --window / --tab / --pane accept.

URL	Selector forms
otty://window/<sel>	w_<id>, or current · last · a 1-based index · title:<pattern>
otty://tab/<sel>	t_<id>, or a 1-based index
otty://pane/<sel>	p_<id>, or a session id such as $OTTY_PANE_ID

Get the ids from otty pane list (or otty tab list / otty window list). The $OTTY_PANE_ID environment variable is exported into every pane's shell, so a running command always knows its own pane.

Notes

• Otty navigates without a confirmation prompt — an otty:// link only moves focus, it never runs a command or changes your files.
• If Otty is not running, the link launches it first, then focuses the target once a window is available.
• An unknown or stale selector is a no-op; Otty just comes to the front.

See also

• CLI Reference — the otty command and its --window / --tab / --pane selectors.
• Using the CLI in your Shell — scenario-oriented examples, including deep links.