Skip to content

arul28/ADE

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

391 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ADE

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

Website  ·  Docs  ·  Download  ·  Changelog

100% Free Open source AGPL-3.0 license Latest release CI status

ADE on macOS   ADE on iOS

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.


Parallel worktrees

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.

An agent executing live
Pull request review

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.

The CTO agent
ADE on iOS

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 doctor --json
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. Runtime state lives under .ade/ inside each project — SQLite db, worktree checkouts, proof artifacts, encrypted secrets.

apps/desktop   Electron host — SQLite, git, processes, AI runtimes, sync host
apps/ade-cli   Node CLI over the desktop socket (or headless)
apps/ios       SwiftUI companion that syncs with a desktop host
apps/web       Public website and download surface
docs/          Product and engineering docs

Deep reference: ARCHITECTURE.md.

Develop

cd apps/desktop && npm install && npm run dev      # live Electron app
cd apps/ade-cli && npm install && npm run build    # build the CLI

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.