docs menu: tiles
docsusing easl
tiles
What each tile shows and does.
on this page
A board holds tiles and drawings. You and your agents change the same objects.
- Right-click an empty part of the board for New Terminal Here, New Note Here or New Browser Here.
- The File menu centers new tiles in your view.
Select a tile and press Return, or click into it, to use it. Esc returns the keyboard to the board. Terminals and web pages keep Esc, so ⌘Esc (View › Leave Tile) leaves any tile.
terminal
A libghostty terminal. Its zmx session outlives the app. ⌘T opens one (1000×620 pt) in your view.
- Your Ghostty config sets theme, colors, font family, padding, keybinds and selection colors. easl keeps its own font size. For bigger text, use content zoom.
- ⌘-click a
path:linein the output to open that code in the terminal’s one preview tile, beside it. ⌥⌘-click opens a separate tile you keep. It readssrc/foo.ts:42,:42:7,:10-20,foo.rs#L10-20, Python tracebacks (File "core.py", line 2651) and pdb frames. - Command status. easl loads Ghostty’s shell integration. The header shows the last command’s result:
exit 1 · 42 sfor a failure, the duration for a long success, nothing for a quick one. ⌘↑ and ⌘↓ jump between prompts. - Notifications and bells at the shell prompt raise an attention marker, unless you’re looking at the tile.
- Scrolling moves the scrollback, or pans the board over an unfocused full-screen program. Click in to scroll the program.
code
The whole file, read-only, scrolled to a range. Open one with File › Open File as Code Tile… (⌘O), ⌘P, a ⌘-click in a terminal, or a link in a note or page.
-
Gutter signs work like nvim’s gitsigns: a green bar for added lines, blue for modified, a red wedge for deleted. Click a sign to see the old lines. The base is the merge-base with the default branch, or HEAD. The header’s picker switches it.
-
Navigation (Code menu):
- Hover shows signatures.
- Go to Definition ⌃⌘J. ⌃⌥⌘J opens it in a new tile.
- Find References ⌃⌘R. Open All lays them out as captioned excerpts in a group.
- Outline ⌃⌘O. Type to filter.
From a language server, else text search.
-
⌘F finds in the focused or selected tile. Keys in the tile: ↑/↓ or j/k move a row, Space and ⇧Space a page, plus Home and End.
-
Captions. An agent’s caption under the header says why those lines matter. The range stays on its code as lines move above or inside it. “⚠︎ stale” in the header means the code is gone.
-
Pinned to a commit, it shows the file at that commit (“pinned at <sha>”).
-
Edit Here opens your
$VISUALor$EDITORin a terminal beside the tile.
follow tile
Each agent terminal has one code tile that follows the file and line the agent last read or edited. On by default, it appears with the agent’s first read.
- A strip under the header lists recent places, newest first. A pencil marks an edit. Edited rows flash for about 3 seconds.
- Scroll or click in it and it holds still for about 10 seconds, counting what it missed. N new ▸ catches up.
- Pin keeps the view as a tile. Right-click the terminal › Follow Files turns it off.
- It ignores images, PDFs and other binaries, files over 4 MiB, scratch files in the temp directory, and missing files.
changes
An agent’s diff, reviewed like a pull request: File › Review Changes (⇧⌘R). See reviewing work.
notes
Markdown. Double-click or Return edits the raw text. Click away or Esc saves. ⌘↩ saves and leaves. ⌘N makes a new note in editing mode.
Code fences stay live against the files they quote:
```ts file=src/store.ts#L41-60
```
```ts file=src/store.ts symbol=restore
```
```ts file=src/store.ts#L41-48 propose
export async function restore(id: string) {
```
- An excerpt (
file=path#L10-40orsymbol=Name) renders the real lines from disk and tracks them as the file changes. A lost anchor shows a stale badge. - A
proposefence is a diff against the real range. It shows “✓ applied” once the file matches. - A plain fence is your text, highlighted.
path:linereferences link anywhere: prose, headings, tables, inline code.shows an image. Tables wrap to the note’s width.
If an agent changes a note while you type, a banner says so. You lose nothing:
- ⌘↩ saves yours.
- Esc keeps theirs (“Kept their version of the note · ⌘Z puts yours back”).
A note’s menu has Copy as Markdown and Save as Markdown…. Both keep links and fences as written.
html
Sandboxed explainer pages, usually an agent’s. Network is blocked unless the tile allows listed hosts.
Each preloads:
- Tailwind, themed to the app
- Mermaid
- grounded components:
<canvas-code>,<canvas-link>,<canvas-decisions>,<canvas-compare>
Code links open code tiles. File › New HTML Tile (⇧⌘H) makes one. Its menu has Save as HTML… and Open in Browser.
browser
WebKit pages. File › New Browser Tile… (⇧⌘B) opens one. omp’s browser tool drives them.
- They share one profile. easl › Clear Browsing Data… empties it.
- ⌘L goes to the address field. ⌥⌘I (View › Show Web Inspector) opens Safari’s Web Inspector.
- Console errors, uncaught exceptions and failed requests since page load show as a red “2 errors” in the address bar. Hyper-click one in its list to mention it.
- A failed load says so (“Can’t reach localhost:5391”), with Retry. A local address retries until its server answers.
- An unseen page is hidden from WebKit, released 2 minutes later and reloaded when you return. A page an agent drives stays live 60 seconds after its last command.
- Snapshot to Image (the tile’s menu) freezes the page as an image tile beside it, kept as before/after evidence.
image
An image file with an optional one-line caption, like a notebook’s output cell: png, jpg, gif, webp, heic, tiff, bmp, svg, or a PDF’s first page. It reloads when the file changes.
drawing
The top toolbar has:
- rectangles (R)
- ellipses (O)
- arrows (A)
- text (T)
- ink (P)
- V selects
Shape tools return to Select after one shape. Ink stays on until Esc or V.
- Arrows are straight, orthogonal, or routed around tiles. An end dropped on or near a tile or shape binds to it.
- ⌘G groups the selection into a titled, tinted region. Double-click a group to enter it.
- Mention a drawing to tell the agent what it encloses, overlaps and connects.
sharing
Edit › Copy as Image (⇧⌘C) and File › Export Selection as PNG… (⇧⌘E) draw the selection without author marks, close buttons, dot grid or selection. Save sheets open in your last save folder, else Downloads, never inside the board’s repository.