Quickstart
From opening Spec ADE to your first chat turn with an agent — just a few minutes.
Requires Node.js 18+ and internet to download the CLI.
Start the workspace
One command for macOS, Linux, and Windows. The CLI downloads the binary, starts the server on port 4123, and opens your browser.
npx -y @spec-ade/cli@latestOpen http://localhost:4123 manually if the browser does not launch. If port 4123 is busy, the CLI picks the next free port and prints the URL in your terminal.
Your first three steps
Create a project
A project points at a folder on your machine. Each project has many sessions and its own saved pane layout.
Open a session
Pick the CLI type for the session — Auggie (●) or Claude (◆). The session is created eagerly with a real UUID.
Chat with the agent
Type your request and hit Send. The agent runs in the embedded terminal; you see output stream in real time.
Want the agent to run until a goal is met? Use the Send with Goal button next to Send — see the Goal page.
The window layout
The workspace uses a “floating card” style: a left drawer for projects/sessions, a header above the content, and the rest is a pane tree you can split freely. Each pane holds one or more tabs.
Shareable state (projects, sessions, layouts) lives in settings.json via the backend. localStorage only holds device-specific UI state like open tabs or scroll position — do not expect it to sync across machines.