skip to content
easldownload
docs menu: troubleshooting and uninstall

docsreference

troubleshooting and uninstall

Manage sessions from the shell, fix common problems and remove every file easl writes.

on this page

terminal sessions

Every terminal tile runs in a zmx session named canvas-obj_…. To see or end sessions without the app:

zmx list                 # every session; easl's are canvas-obj_…
zmx kill <name>          # end one

For what closing a tile, tab or window ends, see agents.

common snags

Symptom What to do
Terminal tiles don’t start Install zmx: brew install neurosnap/tap/zmx.
The easl CLI or the omp extension won’t run Install bun: brew install oven-sh/bun/bun.
omp shows no dot Link the omp extension (see agents), then start a new omp session in a tile.
Gemini CLI shows no dot 0.60 and later runs as a plain terminal. Paste mentions with Hyper-V.
A Codex tile is orange right after launch Codex asks whether to trust the folder. Answer in the terminal.
“The socket exists but connecting to it failed … a sandbox may be blocking” The app is up. The agent’s sandbox blocks the socket. Run the easl command outside it (Codex: with escalated permission).
A navigation panel says “text search, no language server” Install the server, or point EASL_LSP_<LANGUAGE> at it. See language servers.
“⚠ git failed: …” in a code tile’s header Git cancelled, timed out or failed. It clears on the next load.
Terminal text too small Content zoom: ⌃⌘= (see navigation).
A page shows “Can’t reach localhost:…” Its server isn’t up yet. A local address keeps retrying. Retry asks now.
Lost on a big board ⌘9 (Zoom to Fit), ⌘[ (Back) or the “Back to content” pill.

what easl leaves alone

easl writes no shell, agent or Ghostty config.

Claude Code, Codex, opencode and Gemini CLI get their integration per session, only inside easl tiles. See agents.

Shell history from tiles goes to your usual ~/.zsh_history.

uninstall

  1. End terminal sessions first, or they keep running: zmx kill <name> for each canvas-obj_… session in zmx list.
  2. Delete /Applications/easl.app.
  3. Delete ~/Library/Application Support/Easl/ (boards, archived ones too, and open-boards.json).
  4. Delete the browser profile: ~/Library/WebKit/net.waldin.easl/, ~/Library/Caches/net.waldin.easl/, ~/Library/HTTPStorages/net.waldin.easl*. Or first use easl › Clear Browsing Data….
  5. Run defaults delete net.waldin.easl (export folder, lasso setting, window frames).
  6. Delete $(getconf DARWIN_USER_CACHE_DIR)net.waldin.easl. In $(getconf DARWIN_USER_TEMP_DIR), delete net.waldin.easl, easl-renders, easl-exports and canvas-gemini.
  7. Delete ~/.local/state/zmx/logs/canvas-obj_*.log.
  8. Delete the omp extension symlink ~/.omp/agent/extensions/easl.ts and, if you used Claude Code, ~/.claude/plugins/data/canvas-inline.
  9. Optional: Codex’s trust_level entries for your repos in ~/.codex/config.toml, and ~/.easl/compositions.

easl board.export writes a board to .easl/board.json in your repository. Delete it if unwanted.