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
- End terminal sessions first, or they keep running:
zmx kill <name>for eachcanvas-obj_…session inzmx list. - Delete
/Applications/easl.app. - Delete
~/Library/Application Support/Easl/(boards, archived ones too, andopen-boards.json). - 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…. - Run
defaults delete net.waldin.easl(export folder, lasso setting, window frames). - Delete
$(getconf DARWIN_USER_CACHE_DIR)net.waldin.easl. In$(getconf DARWIN_USER_TEMP_DIR), deletenet.waldin.easl,easl-renders,easl-exportsandcanvas-gemini. - Delete
~/.local/state/zmx/logs/canvas-obj_*.log. - Delete the omp extension symlink
~/.omp/agent/extensions/easl.tsand, if you used Claude Code,~/.claude/plugins/data/canvas-inline. - Optional: Codex’s
trust_levelentries 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.