skip to content
easldownload

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

  1. Install it with Homebrew. Installing by the full name trusts only this cask, so there’s no brew trust step. brew upgrade --cask easl updates it: it quits easl first, and terminal tiles keep running.

    brew install --cask twaldin/tap/easl
  2. Or paste this in Terminal. It checks for macOS 14 on Apple silicon, downloads easl-0.3.9.zip, verifies its SHA-256 and moves easl.app to /Applications (~/Applications if that isn’t writable), with no sudo. The script installs easl.app and nothing else; zmx and bun come from Homebrew, below. Read the script.

    curl -fsSL https://easl.sh/install | sh
  3. Or download the zip, easl-0.3.9.zip, from GitHub Releases. Unzip it and move easl.app to /Applications. It’s signed with a Developer ID and notarized by Apple, so it opens like any downloaded app.

  4. Install zmx (for terminal tiles) and bun (for the easl CLI 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 easl
scripts/bundle.sh release

Then 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/extensions
ln -sf /Applications/easl.app/Contents/Resources/extensions/omp/easl.ts ~/.omp/agent/extensions/easl.ts

language 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

  1. Open a folder: File › Open Board… (⇧⌘O). Every worktree and branch of a repo opens the same board, as a tab.

  2. Press ⌘T for a terminal and run any agent CLI: omp, claude, codex, gemini, opencode, aider. It uses your Ghostty config.

  3. A new Codex tile first asks whether to trust the folder. Answer in the terminal.

  4. Help › easl Basics (⌥⌘/) explains the dots, markers, tray and keys.

uninstall

End the terminal sessions first:

zmx list
zmx 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, and defaults 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.