Skip to main content
Optional UI:
Requires Node 22. The packages ship ESM + CJS.

Isolated home

Pass a directory your app owns. The sidecar stores thread keys and runtime state there. Never point it at the developer’s ~/.ade or at ADE’s default machine socket.
In Electron, use the main process and a path under userData:
Two clients on one home fight over the same socket and SQLite root. Open one client per isolated home.

Where ade comes from

Resolution order:
  1. binaryPath — pin a specific build; skips PATH and download.
  2. A previously downloaded binary in the home cache.
  3. ade on PATH (optional; tests can disable this).
  4. Download from the ADE GitHub release, fail-closed against that release’s SHA256SUMS.
Downloads verify checksums before the binary is used. A mismatch is a hard error (checksum_mismatch), not a warning.

Electron

Run @ade-dev/sdk from the main process, not the renderer. Spawn owns a child process and a Unix socket (or a Windows named pipe). Bridge events to the renderer yourself, or put @ade-dev/chat-ui behind a preload that talks to main.

Windows

The sidecar is a supported host. Named pipes are hashed from home + user identity. taskkill / tar are resolved through the kernel GLOBALROOT System32 alias, never from PATH. .cmd / .bat wrappers spawn through ComSpec.

Next

Quickstart

Open a thread and send the first message.