A single native workspace for every AI coding agent.
macOS, iOS, CLI — synced in real time.

Website  ·  Docs  ·  Download  ·  Changelog

 

ADE runs Claude Code, Codex, Cursor, opencode — every major AI coding agent — inside one native workspace. Every task is its own git worktree, so agents ship features in parallel. Review and merge PRs in-app. Approve a diff from your phone while another agent tests on your Mac.

Free, open source, local-first. Bring your own keys or subs.

---

	Manage worktrees. In parallel. Every task gets its own git worktree. Branch, edit, test, and commit side by side — no stashing, no rebasing, no context switch.
Every coding agent. One workspace. Claude Code, Codex, Cursor, opencode — pick whichever model fits the task. All run against the same worktree, with live diffs and approval gates.
	Open, review, and merge PRs. Every PR your agents open lands in ADE — diff, CI, comments, merge button. No GitHub tab. Auto-merge when green.
The conductor for your agents. An always-on CTO with context across every worktree. Pulls work from Linear, dispatches to the right worker, reports back when it's done.
	Everything above. On your phone. Every worktree, every agent, every PR — synced to iOS. Start a task on macOS, approve the diff from the train.

Plus files, terminals, git history, workspace graph, multi-tasking, Linear sync, long-running missions, cron automations, computer-use proofs, and the ade CLI.

Install

Download the DMG from GitHub Releases, drag ADE.app into /Applications, open it on any git repo, and add a provider key (or subscription) in Settings. Runs in Guest Mode without an account.

Requirements: macOS 13+, git on PATH, Node 22+ for headless CLI workflows.

CLI

ade desktop
ade runtime status --text
ade runtime start
ade runtime stop
ade doctor --json
ade code
ade lanes create --name fix-checkout-flow
ade prs checks 168 --text
ade tests run --suite unit --wait
ade actions list --text   # discover every service action

CLI reference →

Architecture

Local-first, on purpose. The center of ADE is the runtime daemon — a single per-machine ade service that owns projects, lanes, chats, processes, sync, and proof artifacts. Desktop, the terminal client, the iOS app, and SSH-attached desktop windows all attach to it as clients. Runtime state lives under .ade/ inside each project (SQLite db, worktree checkouts, proof artifacts, encrypted secrets) and the machine-wide socket lives under ~/.ade/sock/ade.sock.

apps/ade-cli   ADE runtime daemon (`ade serve`) + `ade` CLI + `ade code` terminal client
apps/desktop   Electron client — multi-window, attaches to a local or SSH-bound runtime
apps/ios       SwiftUI controller that attaches to a runtime over WebSocket
apps/web       Public website and download surface
docs/          Product and engineering docs

Deep reference: ARCHITECTURE.md.

Develop

First-time setup:

npm run setup

Daily desktop dev:

npm run dev

That aliases to npm run dev:desktop: it rebuilds apps/ade-cli, launches the Electron desktop app, and points it at the dev runtime socket /tmp/ade-runtime-dev.sock. If no dev runtime is listening, desktop is allowed to create it. This is the normal desktop-dev flow.

Dev command matrix:

npm run dev:desktop          # desktop only; dev socket; desktop may auto-create runtime
npm run dev:desktop:attach   # desktop only; fail if dev runtime is not already running
npm run dev:desktop:clean    # desktop only; clear Vite cache before launch
npm run dev:code             # terminal TUI only; starts dev runtime if missing
npm run dev:code:attach      # terminal TUI only; fail if dev runtime is not already running
npm run dev:runtime          # runtime only in the foreground
npm run dev:all              # start shared dev runtime, then run desktop/code attach commands in separate terminals
npm run dev:stop             # stop the dev runtime
npm stop dev                 # same as dev:stop

The dev commands intentionally use a temp socket so they do not collide with the installed ADE app:

/tmp/ade-runtime-dev.sock

Override it when needed:

npm run dev:desktop -- --socket /tmp/my-ade-dev.sock
npm run dev:code -- --socket /tmp/my-ade-dev.sock
ADE_DEV_RUNTIME_SOCKET_PATH=/tmp/my-ade-dev.sock npm run dev:runtime

To test auto-runtime creation, use the :auto/default commands after stopping the dev runtime:

npm run dev:stop
npm run dev:desktop          # tests desktop creating the dev runtime
npm run dev:stop
npm run dev:code             # tests TUI wrapper creating the dev runtime

Local packaged builds:

npm run package:alpha        # current checkout -> ADE Alpha.app, ade-alpha, ~/.ade-alpha
npm run package:beta         # origin/main -> ADE Beta.app, ade-beta, ~/.ade-beta

These are unsigned local macOS app builds under apps/desktop/release-alpha and apps/desktop/release-beta. They do not replace the production ADE.app, production ade, or ~/.ade runtime/state. Local channel packages include the host runtime binary for this Mac. Release builds still require the full cross-platform runtime artifact set used by remote runtime bootstrap.

Validate with npm --prefix apps/desktop run typecheck and run test. The desktop test suite is large — run the smallest relevant subset first.

Links

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

License

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