ade CLI

Project & lanes

ade init                                # add the current directory as a project
ade projects list --text                # list registered projects
ade lanes list --text                   # list lanes in the active project
ade lanes create "fix-checkout-flow"    # create a lane from the default branch
ade lanes create "auth-ui" --parent auth-base  # stack a lane on another lane
ade lanes reparent auth-ui --parent auth-base  # restack an existing lane
ade lanes delete <lane-id> --force --delete-branch

Chats & sessions

Start and inspect agent chats, terminals, and CLI sessions inside a lane.

ade chat list --lane <lane-id> --text
ade chat create --lane <lane-id> --model gpt-5.5
ade shell start-cli codex --lane <lane-id> --permission-mode edit --message "fix failing tests"
ade shell start --lane <lane-id> -- npm test
ade code                                # open the terminal UI

Git & PRs

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" --text
ade prs list-open --text
ade prs checks <pr> --text              # CI status for a PR
ade prs comments <pr> --text

Tests

Run test suites in a lane.

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 codex
ade linear attach --this-session --issue-id ENG-431
ade linear comment "Pushed a fix; CI running"
ade linear set-state ENG-431 <state-id>

Account & machines

Link this machine to your ADE account so you can reach it from ADE desktop, the web client, and iOS. ade connect is idempotent — re-running it on a connected machine just prints status.

ade connect                             # sign in, install the service, publish this machine
ade connect --status --text             # report the three steps, change nothing
ade connect --headless                  # copy-paste device flow (SSH, no browser)
ade connect --no-login                  # service only; stay local/LAN-only
ade connect --no-service                # account only; skip the login service
ade connect --timeout 120               # seconds to wait for the machine row (default 60)
ade login                               # sign in without touching the service
ade machines list --text                # machines registered to this account
ade machines reconnect                  # re-pair this machine after it was removed
ade logout                              # undo the account half of connect

The machine row is published by the running brain, not by this command — so the brain must stay running for the machine to remain reachable. Full walkthrough, including running the brain on a Linux server: Connect a machine.Removing a machine from your account is deliberate and terminal: heartbeats never re-register it, and its Activity, notifications, and Live Activities stop. ade machines reconnect is the way back. It takes no selector — it always re-pairs the machine you run it on — and it needs proof of a freshly completed interactive sign-in, so it prompts for one when the account directory asks and finishes the re-pair as soon as that lands. Only once the directory accepts does it lift the push gate, so Activity, alerts, and badges resume without restarting the brain. A normal ade login runs the same repair automatically, and ADE desktop offers it as Reconnect this computer in Settings.

Brain & pairing

Control the machine-owned ADE runtime (the brain) and pair a phone.

ade brain status --text                 # endpoint, service, and sync state
ade brain start                         # load the login service
ade brain stop                          # unload the login service
ade brain restart                       # re-exec after an app update
ade brain pin generate                  # generate a phone pairing PIN
ade 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 command
ade actions list --text                 # full service-backed action catalog
ade actions run git.stageFile --arg laneId=<lane-id> --arg path=src/index.ts
ade doctor                              # local runtime, git, provider readiness
ade skill list --text                   # bundled agent skills

ade code (terminal)

The interactive terminal UI built on the same runtime.

Architecture

How the control plane, runtime, and clients fit together.

Settings

AI Connections

For developers

Output modes

Command groups

Full reference

ade CLI README

ade code (terminal)

Architecture

​Output modes

​Command groups

​Full reference

ade CLI README

ade code (terminal)

Architecture

Output modes

Command groups

Full reference