skip to content
easldownload
docs menu: navigation

docsusing easl

navigation

Go to, ⌘J, Zoom to Fit, walkthrough steps, Back and Forward, and the keyboard shortcuts.

on this page

Navigation keys work wherever the keyboard is, even in a terminal or web page.

pan and zoom

  • Trackpad: scroll pans, pinch zooms.
  • Mouse: the wheel pans, ⌘-scroll zooms at the pointer, ⇧-scroll pans sideways.
  • Zoomed far out, tiles become cards: pictures tinted by agent state. Zoom in to use them.
  • Off-screen tiles stop drawing. Their sessions keep running.

Go to… (⌘P)

A search panel in the window. It lists, in order:

  1. What needs you, flagged Blocked, Marked or Done.
  2. Recent code locations.
  3. Every group and tile, by title, caption, path or terminal name.
  • Type a path to open a file. core.py:120 opens at a line.
  • @name finds a symbol.
  • Once you type, note headings match too.
  • Go to frames an agent’s terminal and its follow tile together when both fit.

needs you (⌘J)

⌘J goes to the next thing that needs you. Press it again for the next. For the order, see agents.

Off screen, a pill at the view’s edge points at it. Click the pill to go there.

Zoom to Fit (⌘9) and Back to content

⌘9 frames the main cluster of work, skipping far-off strays. In empty space, a “Nothing here · Back to content” pill at the bottom brings you back.

zoom and scale

Zoom stops at 100%. ⌘= and ⌘- step through 10, 15, 25, 33, 50, 67, 75, 90 and 100%. ⌘0 is actual size, or shows the selection at 100%.

For bigger text, use content zoom (Object › Content Zoom). It zooms a tile’s content in place:

  • ⌃⌘= and ⌃⌘- step through 25–500%. ⌃⌘0 goes back to 100%.
  • Or use the title bar’s − % +. Clicking the % resets it.
  • The tile keeps its size and its text reflows. In a terminal, the text gets bigger with fewer columns. Images don’t zoom.
  • A corner drag resizes. ⌥-drag keeps proportions.

step through the board

⌥⌘↑ ⌥⌘↓ ⌥⌘← ⌥⌘→ move to the nearest tile in that direction. A terminal you land on takes the keyboard. ⌘Esc leaves it.

An agent’s walkthrough joins its stops with next-step arrows, labelled like “1 · parse”. From a selected stop, ⌥⌘→ and ⌥⌘← follow them in order, whatever the layout. Each stop shows whole, centered if off screen. The ends say “Last step” and “First step”.

back and forward (⌘[ ⌘])

⌘[ and ⌘] retrace where you went: Go to, definitions, ⌘-clicked references, links, ⌘J, ⌘9, walkthrough steps and Review Changes. Back after stepping selects the previous stop.

A path:line link, Go to, a definition or a ⌘-click reuses a code tile already showing those lines, else opens them beside you.

Hide Board Chrome (⌥⌘T)

View › Hide Board Chrome hides, for presenting, the toolbar, tray, selection rings, author marks, code tile header rows and agent markers. A blocked agent’s ring, bubble and edge pill stay. Esc, or the item again, restores them.

keyboard shortcuts

Every action is also in the menu bar, so menu search (Help, ⌘?), Full Keyboard Access and VoiceOver reach it.

Keys Action
⌘T New terminal
⌘N New note
⇧⌘B New browser tile
⇧⌘H New HTML tile
⌘O Open a file as a code tile
⇧⌘O Open a board (a folder)
⇧⌘R Review Changes
⌘P Go to…
⌘J Go to next needs-you
⌘9 Zoom to Fit
⌘0 Actual size (100%)
⌘= / ⌘- Zoom in / out (10–100%)
⌃⌘= / ⌃⌘- / ⌃⌘0 Content zoom in / out / 100%
⌥⌘← → ↑ ↓ Move between tiles; step along next-step arrows
⌘[ / ⌘] Back / Forward
Return Enter the selected tile
Esc Give the keyboard back to the board (not in a terminal or page)
⌘Esc Leave any tile
⌘W Close the selection, else the focused terminal
⌘G Group the selection
⇧⌘[ / ⇧⌘] Send to Back / Bring to Front
⌘F Find in a code tile
⌘L A browser tile’s address field
⌥⌘I Web Inspector for a browser tile
⌃⌘J Go to Definition
⌃⌥⌘J Open Definition in New Tile
⌃⌘R Find References
⌃⌘O Outline
Hyper-click (⌃⌥⇧⌘-click) Stage a mention
⇧⌘M Mention what the keyboard is on
⌃⌥⇧⌘V Paste mentions into a terminal
⌘Z / ⇧⌘Z Undo / Redo (yours or an agent’s)
⇧⌘C Copy as Image
⇧⌘E Export Selection as PNG…
⌥⌘T Hide Board Chrome
⌥⌘/ easl Basics
V R O A T P Drawing tools: select, rectangle, ellipse, arrow, text, ink

coming from linux or windows

  • ⌘ is your Ctrl. ⌘ (Command; the Windows key on a PC keyboard) does Ctrl’s job: ⌘T, ⌘W, ⌘Z, ⌘C, ⌘V, ⌘= and ⌘- to zoom. A Ctrl shortcut on the board shows a notice naming its ⌘ key, once per key per session.
  • ⌃ stays the terminal’s. ⌃C interrupts. ⌃D ends input.
  • ⌥ is Alt. For Alt as Meta (Alt-B, Alt-F), set macos-option-as-alt = true in your Ghostty config.