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:
- What needs you, flagged Blocked, Marked or Done.
- Recent code locations.
- Every group and tile, by title, caption, path or terminal name.
- Type a path to open a file.
core.py:120opens at a line. @namefinds 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 = truein your Ghostty config.