Your workspace for every AI coding agent.
macOS, Windows, iOS, and CLI all synced in real time. (android mobile app almost ready)

ADE runs Claude Code, Codex, Cursor, Factory Droid, OpenCode (more coming soon) in one workspace that you can open from any machine you own, the web, or a mobile app. The best part? It's completely free.

Simply sign in to ADE on a machine you own, and you can magically run and manage agents from any other ADE client. In real time, every single ADE chat or CLI session (yes even your CLI sessions) syncs to every other device.

I can start a thread on my desktop at home, pick it up on my phone at the gym, and then finish it off from a website on my friend's computer. It works like magic, and removes the friction of managing agents on the go.

Beyond agent management, ADE (like the name implies) offers a full development environment. This means git management, a full file editing/viewing experience like VS Code, PR management, automations, GitKraken inspired history, and more. This one app is meant to replace every single modern dev tool.

Desktop app The full workspace. Every agent and every worktree, tiled side by side. macOS and Windows.	Web client The same workspace in a browser at app.ade-app.dev. Nothing to install — sign in and your machines are there.
Terminal ade code is ADE, terminal-native — the same worktrees, chats, and PRs in a fast TUI. Works over SSH.	Mobile app Every worktree, agent, and PR synced to iOS. Start a task on the desktop, approve the diff from the train.

Think of ADE as having 4 UI clients (web, desktop app, terminal, and mobile app) you can interact and work with. Each one of those clients needs to connect to a machine, and it does that via "ADE Brain". You can install the Brain to any machine, and magically it will then be accessible and controllable by any of those UI clients. The machine just needs to stay on, and suddenly you get a full agentic development experience from anywhere.

This one command below installs the ADE brain — the always-on engine that every ADE UI client talks to. Running this command will also optionally ask you to install the desktop app, which is one of the four UI clients, and the most powerful one. This command will also ask you to sign up or login to your ADE account. Your ADE account is what lets you seamlessly connect to all other machines you use. Of course, you can use ADE without an account, you will just have to connect to your machines to an ADE Brain via LAN, Tailscale, or SSH.

macOS and Linux

curl -fsSL https://ade-app.dev/install.sh | sh

Windows (PowerShell)

irm https://ade-app.dev/install.ps1 | iex

Want to install the full Desktop App + Brain via a dmg or exe file? Download it from GitHub Releases or ade-app.dev instead. That gets you the same thing as the above command, but with the above command you can opt out of the desktop app and only install the Brain, these download files bundle it all together. Note - linux doesnt have a desktop app yet, only Brain.

If you already have the Brain installed, and want the desktop app, you can safely run the command above, or install the appropriate download file.

macOS and Windows. Install it with the one-liner above, or download it directly:

macOS · Apple Silicon · macOS · Intel · Windows x64

Requirements: macOS 13+, or Windows 10/11 x64 (ARM64 unsupported)

Windows is in beta and may be a little buggy, PR's and bug reports are encouraged to help grow this project. Due to lack of support and general Windows quirks, some features are not available that work on MacOS, nothing major though. Full detail: docs/development/windows-support.md.

_{If you prefer Homebrew, this command installs the full desktop app + ADE Brain: brew install --cask arul28/ade/ade}

There is no Linux desktop app yet, but it can run the Brain. You can install it on any x64 or arm64 box with the one-liner command from above, and that machine becomes reachable from any ADE UI Client.

Brain-only downloads, if you would rather not pipe a script: darwin-arm64 · darwin-x64 · linux-arm64 · linux-x64 · win32-x64.

Nothing extra to install — once you have the ADE Brain installed, either via the single command above or by installing the full desktop app, you can simply run:

ade code

On macOS and Linux this binary lives in ~/.ade/bin, and the installer asks before adding it to your PATH. It writes ~/.ade/env and drops one marked line into your shell profile, so say yes and new terminals just work. Say no and nothing gets touched, or set ADE_INSTALL_NO_PATH=1 to skip the question. Windows updates your user PATH the same way, and -NoPath skips it. Other overrides: ADE_VERSION to pin a release tag, ADE_INSTALL_DIR for the binary destination, ADE_HOME for the state root.

With no terminal attached — CI, a provisioning script — the installer skips every prompt and prints the follow-up commands instead. ADE_INSTALL_NO_PROMPT=1 (-NoPrompt for PowerShell) opts out explicitly.

Nothing to install. Sign in at app.ade-app.dev and every machine on your account is right there. Any machine running the ADE brain is reachable from it, from any browser.

Available now on TestFlight. App Store coming soon; Android coming soon.

Sign in on the phone to see your machines and connect automatically. If you choose not to create a free account, you can Continue without an account and pair to any machine via direct QR/link, Nearby LAN/Tailscale scan, or SSH pairing. To maintain and relay information between machines, ADE will prefer LAN, then Tailscale, and use its own relay service as fallback to maintain mobile to machine connections. Having an account makes the discovery of machines seamless, and will also allow you to connect off wifi or without Tailscale. But if you have access to internet, or have Tailscale setup on mobile and another machine, then ADE will automatically use that to maintain the connection, it's always a bit faster.

It links a machine to your ADE account — nothing more. Once linked, that machine shows up in every ADe client once you are signed in.

You rarely run it yourself. The install script runs it at the end, and the desktop app does the same job when you sign in. Reach for it when you declined the sign-in prompt, installed non-interactively, or want to check or repair an existing machine:

ade connect                  # sign in, install the service, publish this machine
ade connect --status --text  # report the three steps, change nothing
ade connect --headless       # copy-paste device flow, for SSH sessions
ade connect --no-login       # service only; stay local/LAN-only

ade logout undoes the account half; ade runtime uninstall-service removes the service.

The same ade binary that runs the Brain is your CLI too, so once the Brain is installed you already have it. A taste of what it does:

ade desktop
ade brain status --text
ade code
ade lanes create --name fix-checkout-flow
ade prs checks 168 --text
ade actions list --text   # discover every service action

Full CLI reference →

ADE is local first. The Brain is the always on process that owns your project catalog, the sync websocket, and the authority to actually run things. Every UI client attaches to it, including the desktop app, ade code, mobile, and the web client. Project data stays in .ade/ inside each repo, and machine wide state lives in ~/.ade.

apps/ade-cli   ADE Brain, the `ade` CLI, and the `ade code` terminal client
apps/desktop   Electron desktop app
apps/ios       SwiftUI mobile app
apps/web       Website and download surface
docs/          Product and engineering docs

Deep reference: ARCHITECTURE.md.

npm run setup   # first time only
npm run dev     # rebuild the CLI, refresh the dev runtime, launch desktop

npm run dev uses a temp endpoint and its own Electron profile, so it never touches your installed ADE app or the Brain it talks to.

Everything else lives in docs/development/local-development.md: the full dev command matrix, running a specific lane worktree, previewing the renderer in a browser without Electron, packaging local Alpha and Beta builds, and a table of what to rebuild after a given change.

Validate with npm --prefix apps/desktop run typecheck and npm run test:desktop:sharded for the full desktop suite. The desktop test suite is large, so run the smallest relevant subset first.

Quickstart · Key concepts · Worktrees · Computer use · Changelog · Contributing

AGPL-3.0 — © 2025 Arul Sharma. Free forever. Source on GitHub.