The ade command is the typed control plane for ADE from any shell — the same lanes, chats, PRs, and tests, scriptable for humans and agents alike.
ade is the typed control plane for ADE. Everything you do in the desktop app — create lanes, run agents, ship PRs, kick off tests, attach Linear issues — has a CLI command, so you can drive ADE from any shell. Agents running inside ADE use the same commands, which is how they inspect and operate the workspace they live in.
ade lanes create "fix-checkout-flow" # spin up a worktree for a taskade brain status --text # check the machine runtimeade code # open the terminal UI
Two commands discover everything: ade <group> --help for exact flags on any command, and ade actions list --text for the full service-backed action catalog behind the typed commands.
Most commands take an explicit output mode. Use --text for a human-readable summary and --json for stable, scriptable fields (the default when output is piped).
ade lanes list --text # readable summaryade lanes list --json # stable JSON for scripts and agents
ade init # add the current directory as a projectade projects list --text # list registered projectsade lanes list --text # list lanes in the active projectade lanes create "fix-checkout-flow" # create a lane from the default branchade lanes create "auth-ui" --parent auth-base # stack a lane on another laneade lanes reparent auth-ui --parent auth-base # restack an existing laneade lanes delete <lane-id> --force --delete-branch
Chats & sessions
Start and inspect agent chats, terminals, and CLI sessions inside a lane.
Commit, push, and turn a lane into a pull request; read CI and comments.
ade git commit --lane <lane-id>ade git push --lane <lane-id>ade prs create --lane <lane-id> --base main --title "Fix checkout flow" --textade prs list-open --textade prs checks <pr> --text # CI status for a PRade prs comments <pr> --text
Tests & run
Start dev processes and run test suites in a lane.
ade run defs --text # list configured run targetsade run start web --lane <lane-id>ade tests run --lane <lane-id> --suite unit --wait
Linear
Attach and update Linear issues through ADE’s own Linear connection — no API key needed.
ade lanes create-from-linear --issue-id ENG-431 --start-chat --provider codexade linear attach --this-session --issue-id ENG-431ade linear comment "Pushed a fix; CI running"ade linear set-state ENG-431 <state-id>
Brain & pairing
Control the machine-owned ADE runtime (the brain) and pair a phone.
ade brain status --text # endpoint, service, and sync stateade brain start # load the login serviceade brain stop # unload the login serviceade brain restart # re-exec after an app updateade brain pin generate # generate a phone pairing PINade brain pin set 123456 # set an explicit pairing PIN
Proof
List the computer-use proof artifacts ADE captured for a chat or session.
ade proof list --arg ownerKind=chat --arg ownerId=<session-id>
Discovery
Find commands, flags, and the full action catalog, and check local readiness.
ade <group> --help # exact flags for any commandade actions list --text # full service-backed action catalogade actions run git.stageFile --arg laneId=<lane-id> --arg path=src/index.tsade doctor # local runtime, git, provider readinessade skill list --text # bundled agent skills
Prefer typed commands — they validate arguments and return stable fields. Reach for ade actions run <domain.action> only when no typed command covers the workflow yet.
