Desktop
The desktop app is the host. Agents run on this machine. Start chatting right away.
Install
The app is coming soon. Settings can install the CLI for you — that is the binary reachability needs.
First launch
- Spellbook shows the agents from the public ACP registry.
- Select the ones you already use (Claude Code, Codex, Grok, Gemini, …).
- Continue installs them and opens New session.
The first selected agent is already in the setup bar. Pick a folder, then send a prompt. Add or remove agents later from Manage agents in the command menu.
Custom agents
Anything that speaks ACP can be added as a custom agent: command, args, and env. Registry
entries that only ship a binary download are skipped for now — npx and
uvx work.
This machine as a host for others
Click this machine's name at the left of the status bar and turn on
Reachable from your devices. That starts
spellbook gateway here, and every Spellbook signed in to your account can
open chats on it. Quitting the app does not stop it; turning it off does. See
Pair a host.
Cloud is optional
Sign in from Account when you want a hosted sandbox in the same catalog. Local agents keep working either way. See Cloud.