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.
userData:
home fight over the same socket and SQLite root. Open one client per isolated home.
Where ade comes from
Resolution order:
binaryPath— pin a specific build; skips PATH and download.- A previously downloaded binary in the home cache.
adeonPATH(optional; tests can disable this).- Download from the ADE GitHub release, fail-closed against that release’s
SHA256SUMS.
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.
