docs menu: getting started
docsstart
getting started
Install easl, open a folder and run your first agent.
on this page
easl is a Mac app for macOS 14 or later on Apple silicon. Your agents run in real terminals on a board, beside code tiles, call graphs, a browser and notes, and a ⌃⌥⇧⌘-click on any of those puts it in the agent’s next prompt. This page installs easl, opens a folder and starts an agent.
install
-
Install it with Homebrew.
brew upgrade --cask easlupdates it; it quits easl first, and terminal tiles keep running:brew install --cask twaldin/tap/easl -
Or run the installer. It downloads the latest release, checks its SHA-256 and moves
easl.appto/Applications(read it):curl -fsSL https://easl.sh/install | sh -
Or download
easl-<version>.zipfrom GitHub Releases, unzip it and moveeasl.appto/Applications. It’s notarized by Apple, so it opens like any downloaded app. -
Install zmx for terminal tiles and bun for the
easlCLI and the omp extension:brew install neurosnap/tap/zmx oven-sh/bun/bun -
Optional: link the omp extension (see agents).
-
Optional: install language servers for code navigation (see language servers).
or build from source
To run main, build it with the Command Line Tools. Xcode isn’t needed. The changelog lists what the release has.
git clone https://github.com/twaldin/easl.git
cd easl
swift build # debug build
scripts/bundle.sh release # assemble .build/easl.app (ad-hoc signed)
You still need zmx and bun (step 3).
open a folder
- Choose File › Open Board… (⇧⌘O).
- Pick the folder.
Each board opens as a tab. The tab bar’s + opens another.
easl keeps one board per repository, rooted at the main checkout. Every worktree and branch opens it. Opened from a worktree, the board reads that worktree’s code: its files and symbols in Go to (⌘P), its language server, its call graphs. A folder outside git gets its own board.
run an agent
- Press ⌘T for a terminal tile, or right-click the board and choose New Terminal Here.
- Run your agent:
omp,claude,codex,gemini,opencode,aideror any other.
The tile is a real terminal (libghostty, with your Ghostty config). Your own agent runs here, login flow and questions included. Prompt it in its terminal. easl has no composer.
what the dots mean
An agent’s terminal shows its state as a dot in the title bar.
| Dot | State | Means |
|---|---|---|
| Blue | working | Busy. |
| Orange, with a ring and a ✋ bubble | blocked | Waiting for your answer. Click the bubble. |
| Green | done | Finished. Turns grey once you’ve seen it. |
| Grey | idle | Waiting for a prompt. |
| No dot | No agent reports here. |
A pink ring and bubble is an attention marker: “look here”. ⌘J goes to the next thing that needs you. See agents.
easl Basics
Help › easl Basics (⌥⌘/) opens a one-screen legend in the window. It covers dots and markers, the follow tile, the tray, reviewing, zoom and keys. One section is for people coming from Linux or Windows.
It stays open while you work. Close it with its ×, the menu item or ⌥⌘/. Its words show as tooltips on the dots, the tray and the markers.
your agents keep running
Quitting easl or closing a board’s tab ends nothing. Agents keep running in zmx sessions and come back when you reopen the folder. See agents for closing tiles and reboots.