Core concepts

Projects & Sessions

The two basic units of organization in Spec ADE. A project is a working folder; a session is a chat/terminal session with an agent.

Projects

Each project points at a unique folder path on your machine and carries a name, icon, sort order, and last-opened time. A project owns many sessions and its own pane layout.

Project deletion cascades

Deleting a project also removes all of its sessions and its layout entry. Be sure before you delete.

Sessions

Sessions are created eagerly with a real UUID the moment you open one. Each session remembers its CLI type (auggie or claude), a title (plus a custom title if you rename it), tab order, and created/updated timestamps.

Pick the CLI type

Each session runs Auggie (●) or Claude (◆). You choose via a dropdown on the session tab bar.

Drag & rename

Session tabs support drag-to-reorder and double-click to rename.

Restart recovery

The frontend polls the backend boot_id every 5s; when the backend restarts, sessions reload cleanly.