download easl
A free, MIT-licensed Mac app where coding agents run in real terminals on one board, and a ⌃⌥⇧⌘-click puts what you mean in their next prompt.
macos 14 or later · apple silicon · no intel, linux or windows build
download
Install it with Homebrew. Installing by the full name trusts only this cask, so there’s no
brew truststep.brew upgrade --cask easlupdates it: it quits easl first, and terminal tiles keep running.brew install --cask twaldin/tap/easlOr paste this in Terminal. It checks for macOS 14 on Apple silicon, downloads
easl-0.3.9.zip, verifies its SHA-256 and moveseasl.appto/Applications(~/Applicationsif that isn’t writable), with no sudo. The script installseasl.appand nothing else; zmx and bun come from Homebrew, below. Read the script.curl -fsSL https://easl.sh/install | shOr download the zip,
easl-0.3.9.zip, from GitHub Releases. Unzip it and moveeasl.appto/Applications. It’s signed with a Developer ID and 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
what easl leaves alone
easl edits no shell, agent or Ghostty config. Terminal tiles read your Ghostty config and never write it. Codex’s hooks are a per-session override. easl never writes them to ~/.codex.
build from source
This builds main; the changelog says what the release has. The Command Line Tools are enough.
git clone https://github.com/twaldin/easl && cd easlscripts/bundle.sh releaseThen install zmx and bun (step 3). swift build makes a debug build; scripts/dev.sh runs an isolated dev instance. More in the README’s build from source.
the omp extension (optional)
With it, omp in an easl terminal reports its state, drives its follow tile and gets the easl skill. Claude Code, Codex, opencode and Gemini CLI (before 0.60) need no setup (agents).
mkdir -p ~/.omp/agent/extensionsln -sf /Applications/easl.app/Contents/Resources/extensions/omp/easl.ts ~/.omp/agent/extensions/easl.tslanguage servers (optional)
Install the servers you use: sourcekit-lsp (with Xcode or the Command Line Tools), pyright, typescript-language-server, gopls, rust-analyzer. They answer hover, go to definition, references and outline. Without one, easl falls back to text search (language servers).
first launch
Open a folder: File › Open Board… (⇧⌘O). Every worktree and branch of a repo opens the same board, as a tab.
Press ⌘T for a terminal and run any agent CLI:
omp,claude,codex,gemini,opencode,aider. It uses your Ghostty config.A new Codex tile first asks whether to trust the folder. Answer in the terminal.
Help › easl Basics (⌥⌘/) explains the dots, markers, tray and keys.
uninstall
End the terminal sessions first:
zmx listzmx kill <name>- Delete
/Applications/easl.app(with Homebrew,brew uninstall --cask easl) and~/Library/Application Support/Easl/(your boards). - Delete the browser profile and caches under
net.waldin.easl, anddefaults delete net.waldin.easl. - Remove the omp extension symlink,
~/.omp/agent/extensions/easl.ts.
Every path easl writes: the README’s uninstall section, or troubleshooting and uninstall.