docs menu: mentions
docsusing easl
mentions
Hyper-click a line of code, a page element, a note or a drawing into your agent's next prompt.
on this page
A mention points your agent at something on the board. It rides with your next prompt, pinned to what it said then.
hyper-click
Hyper is ⌃⌥⇧⌘ (Control+Option+Shift+Command; on a PC keyboard, Ctrl+Alt+Shift+Win). Map Caps Lock to Hyper with a remapper such as Karabiner.
Hyper-click anything to stage it as a mention. Hyper-click again to unstage.
| Hyper-click on | Mentions |
|---|---|
| A code line or gutter sign | That line, or that whole change |
| A changes tile’s line or hunk header | The line with its side and state, or the whole hunk |
| A note | The block under the pointer (paragraph, list item, table row, fence, or a heading with its section) |
| A web page | The DOM element, with its text and CSS path |
A page’s <canvas>, <video> or <img> |
The element and the pixel you clicked |
| A finished command’s output in a terminal | That command’s whole block: the command, its exit code and its output |
| A drawing | The drawing, with what it encloses, overlaps and connects (a box over a page also lists the elements under it) |
| An image tile | The pixel under the pointer |
| A tile’s title bar | The whole tile |
Hold Hyper to outline what’s under the pointer. Hyper-drag on an empty part of the board to mention everything in the box as one group.
Hyper-click never moves the keyboard.
⇧⌘M: mention from the keyboard
Edit › Mention (⇧⌘M) stages what the keyboard is on:
- in a changes tile, the hunk or lines (
mtoo) - in a code tile, the selected text or range
- in a note, the block you’re editing
- in a page, the text selection
- in a terminal, the selection or the last command
- on the board, the selected tiles
the tray
Staged mentions sit as chips in the tray at the bottom of the window. Empty, it reads: “Hyper-click (⌃⌥⇧⌘-click) anything, or ⇧⌘M, to point your agent at it”.
→ name ▾ on the right is the target terminal. It picks the first of:
- the agent you last typed in
- the board’s only agent (a dev-server shell doesn’t count)
- the last terminal you typed in
Click it to pick another terminal, agents listed first. The choice survives restarts.
edited on a chip means its target changed since you staged it. ✕ removes the chip.
the drain
Submit a prompt in the target terminal. The agent’s integration attaches every staged mention and clears the chips it delivered. A chip staged while it sends stays. The agent gets the mentions as hidden context, in order, so “this” and “that box” mean what you pointed at. A prompt in any other terminal leaves the tray alone.
Agents lists which agents have an integration.
hyper-v: other agents
For agents without an integration, press Hyper-V (⌃⌥⇧⌘V, Edit › Paste Mentions into Terminal). It pastes the staged mentions as text into the terminal you’re typing in, else the tray’s target, and clears those chips. It doesn’t press Return. Finish your prompt and send it.