Getting started
Install ADE, open your first project and run an agent (or build and test a smart contract) in a few minutes.
Install
macOS and Linux
One command installs either:
curl -fsSL https://ade.ardata.tech/install.sh | bash
It picks the build for your machine, checks it against the release’s
SHA256SUMS where the release publishes them, and installs to a
user-writable location without calling sudo. Run it again to upgrade.
--dry-run resolves and verifies the download, then stops before
installing anything.
- macOS: copies the app to
/Applicationsand clears the quarantine flag, so the first launch isn’t blocked. SetADE_PREFIXto install somewhere else. - Linux: puts the AppImage in
~/.local/bin.--dir PATHchanges where, and--debinstalls the.debwith dpkg instead.--debis the one path that needs root; the script says so before it asks.
Pass options after -s -- when piping: curl -fsSL … | bash -s -- --deb.
Builds are not notarised by Apple yet. If you install the .dmg by hand
and macOS says the app “is damaged”, see
Troubleshooting.
Every build is also on the download page
and the latest release: aarch64 for
Apple Silicon, x64 for Intel Macs, .deb for Debian and Ubuntu, and a
portable .AppImage for any distro.
Windows
irm https://ade.ardata.tech/install.ps1 | iex
Windows builds are not published yet, so this reports that and stops. It is ready for when they are: see issue #22.
Install an agent
ADE works with any command-line agent. The agent picker has presets for:
- Claude Code:
npm install -g @anthropic-ai/claude-code - Codex and Ollama (local models)
The fleet view reads Claude Code’s own transcripts, so Claude Code gets the most out of ADE.
First launch
- ADE opens with one terminal in your home folder and a short tour. Skip it or step through it; it won’t show again.
cdinto a project. The file browser, the fleet view and the clickable file links all follow the terminal’s current folder.- Start an agent: type
claude, or press ⌘⇧A to open the agent picker and choose a profile. - Open the scratchpad with ⌘J , write your prompt, and send it with ⌘↵ .
- When the agent writes a file, click its path in the terminal to see it.
The first time you open a project, ADE sets it up for agents: BMAD, the ADE methodology and a team of Claude Code sub-agents, adding only files that are missing. Opened from the New tab dialog, a project with neither BMAD on disk is asked which to use, v6 (the default) or v4; set up any other way, it gets v6. See Project setup.
Shortcuts on this site follow your platform. Switch between macOS and Linux with the buttons in the sidebar.
Where to go next
- Project setup: BMAD, the methodology and agents in every project
- Agents & fleet: the agent picker and fleet view
- Smart contracts: Foundry, Hardhat and Anchor tooling
- Tokens & cost: what sessions cost and how to spend less
- Terminal: tabs, panes, search and clickable files
- Scratchpad: prompt chaining, history and voice
- Auto-save & sync: keep your setup on every machine
- Keyboard shortcuts: the full list