Skip to main content
ADE runs on Linux as the same app, brain, and CLI as on macOS and Windows: lanes, agent chat, PRs, terminals, the built-in browser, and phone pairing all work. On a server with no screen you can run just the brain instead.

​
Requirements

Linux, x64 or arm64

Ubuntu 22.04, Debian 12, or newer. X11 and Wayland desktops both work.

Git

ADE uses branches and worktrees to run lanes.

One AI provider

ADE downloads its own Linux build of each agent.

​
Install

On Ubuntu 24.04 or newer, pick the .deb. Anywhere else, the AppImage is the easy choice because it keeps itself current.
Linux ships through Beta first. If a download below opens a release with no Linux files, open GitHub Releases, pick the newest one marked Pre-release, and download from its Assets list.
Download for x64 or arm64, then:
The first launch adds ADE to your applications menu, makes ade:// links open it, and sets up ADE’s background brain under ~/.ade, so the brain keeps running after you close the app and comes back when you log in. If you move the file, open it once from its new place to update the menu entry.
Already running the brain on this machine? The desktop app connects to it and leaves it in place.

​
If the AppImage will not start

“ADE can’t start from this AppImage.” ADE’s built-in browser opens web pages inside a security sandbox. Ubuntu 24.04 and newer block what an AppImage needs for it, so ADE stops rather than running without one. The .deb works there:
  1. Download the .deb for x64 or arm64. Run uname -m if you’re not sure: x86_64 means x64 and aarch64 means arm64.
  2. Run sudo apt install ./ADE-*.deb in the folder you downloaded it to.
  3. Open ADE from your applications menu.
If you can’t use a .deb and you accept the risk, you can run without the sandbox:
A FUSE error. AppImages need FUSE to mount themselves. Install it with sudo apt install fuse3 (or your distribution’s package), or run ./ADE-*.AppImage --appimage-extract-and-run.

​
Saved sign-ins

ADE uses your desktop’s keyring, such as GNOME Keyring or KWallet, when it has one, and its own encrypted store when it doesn’t.

​
What is different from macOS

Each lane can still have its own Linux screen for agents to drive.

​
Next

Connect a machine

Reach this machine from your other computers and your phone.

ADE Beta

Get new builds first.