skip to content
easldownload
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 (m too)
  • 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:

  1. the agent you last typed in
  2. the board’s only agent (a dev-server shell doesn’t count)
  3. 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.