Appearance
Outline / Jump To
Otty keeps an index of every prompt, command, and file in a pane's scrollback so you can leap straight to any of them instead of scrolling to hunt. The same index drives two views: the Jump To panel and the Outline panel. Both are powered by the prompt marks your shell already emits — you don't change your prompt.
Open it
- Jump To panel — press
⌘J, or open the Command Palette and run Jump To. Type to filter the list, press↩to jump there, andEscto dismiss. A second⌘Jwhile it's open switches to the searchable Current-pane list (see Open Quickly integration below). - Outline panel — open the Details Panel in the sidebar and switch to Outline to keep the list docked while you work.


How it works
When Shell Integration is active your shell emits OSC 133 marks around each prompt and command. Otty uses those marks to build a per-pane index of user commands, with exit status.
- A green tick in the gutter = exit 0
- A red cross = non-zero exit
- A grey dot = still running
Open Quickly integration
⌘⇧O → switch the filter to Current to see every command in the focused pane as a searchable list. Type a fragment of any command to filter, press ↩ to jump there.
See Open Quickly.
Outline in Details Panel
You can also open outline panel in sidebar. In terminal session, it lists all commands you input. In supported code agent session, it also lists your history prompts. In markdown file preview session, it shows all headings in markdown file.
You can right click the row in outline side panel to jump there or copy text content.
See Details Panel.
About This Line
The panels above ask "where is that command?". This asks the opposite: what is this line I'm looking at?
Right-click any row in a pane and open About This Line. The submenu reads the line you clicked:
- The command that printed it, with the time it ran and how long it took — click that row to scroll back to the command itself.
- Which device typed it, when remote access is on. A command you sent from a paired phone or laptop says so; one you typed here says this Mac.
- The pane id — click to copy it.
- Copy Deeplink — a link back to this exact line.
Only the last two appear when the line has no command behind it — a pane without Shell Integration, or output printed before the first prompt.
Deeplinks
A deeplink looks like this:
otty://pane/p_19e630f19fe_21?line=1204Open one — click it anywhere links are clickable, or paste it into a terminal after otty pane focus — and Otty raises that window, switches to that tab, focuses that pane, and scrolls that line into view with a brief highlight.
Paste one into a chat message, a commit note, or a bug report when the thing you're talking about is on screen but 300 lines up. A coding agent working in one of your panes can hand you one too, so "the build failed" comes with a way to go look.
A deeplink points at a live pane, not an archive. The line number is the pane's current scrollback position, so it drifts once that pane's buffer overflows or a resize re-wraps the rows above it, and it means nothing after the pane closes. Use one while it's fresh.
Requirements
- A supported shell with integration hooks installed — see Shell Integration.
- Otty does not require modifying your prompt; it injects via shell hooks.
See also
- Shell Integration — install the OSC 133 hooks.
- Find — search by text, not by command boundary.