ade code, the iOS app, and any SSH-attached desktop window.
The brain
The brain is the source of truth on a machine. It owns lanes, agent chats, terminals, Git operations, PR actions, provider sessions, proof artifacts, the project catalog, and the sync service. It runs every agent — Claude Code, Codex, Cursor, Factory Droid, and OpenCode — against the same projects. Because desktop and CLI clients call the same brain, a chat you start in the app and one you start withade code operate on the same project state.
The brain installs as a per-user login service — launchd on macOS, a systemd user service on Linux, a per-user startup entry on Windows — so it stays running even when no window is open. None of them need administrator rights. The one-command install sets this up, and ade connect publishes the machine to your account so every client can find it.
Because the brain is the whole engine, a machine does not need a desktop app to be useful. On Linux there is no ADE desktop app at all: you install the brain on the server and drive it from a client elsewhere.
Clients
Desktop app
The Electron control plane — windows, navigation, the renderer UI, and platform integrations. Each window attaches to a local brain, or binds to a remote one over SSH. macOS-only integrations such as the Notch and the iOS Simulator drawer are hidden on Windows.
ade code
The terminal-native client. Attaches to the same brain — the same lanes, chats, and PRs in a fast TUI.
iOS app
A SwiftUI controller that pairs with a machine over WebSocket. It mirrors state and sends commands; it never runs agents itself.
ade CLI
The typed control plane for any shell — used by humans and by the agents running inside ADE.
Web client
The same workspace in a browser, for any machine you have connected to your account.
ADE SDK
Third-party apps spawn an embedded runtime as a guest sidecar (
@ade-dev/sdk, @ade-dev/chat-ui). Not a client of the machine brain — an isolated child process.Project state
ADE writes local state under each repository’s.ade/ directory and leaves your source tree under Git’s control:
worktrees/. ADE uses real Git branches, worktrees, commits, and PRs rather than replacing them, so a lane is a normal checkout on disk you can also open in any editor.
Remote runtimes over SSH
A desktop window can bind to a brain on another machine over SSH. ADE runsade rpc --stdio on the remote and tunnels the same JSON-RPC back, so lanes, chats, diffs, and PRs behave exactly as they do locally — but the agents, builds, and tests run on the remote, against its filesystem and its own GitHub, Linear, and provider credentials. The desktop stays local and stays the control plane.
This is the no-account path: the desktop bootstraps the runtime on the far side itself. The alternative is to install the brain on that machine and run ade connect, which publishes it to your account directory so desktop, web, and iOS can all reach it without SSH.
iOS does not SSH into machines. The phone pairs with a brain and connects to its sync websocket over the LAN or a Tailscale tailnet — install Tailscale on both when they aren’t on the same network.
Key concepts
The product vocabulary — brain, lane, stack, CTO — in two minutes.
ade CLI
The typed control plane behind everything ADE does.