Skip to main content
Craft Agents supports connecting to multiple Craft spaces, allowing you to switch between personal notes, work projects, and shared spaces without reconfiguring.
In Craft, workspaces are called “Spaces”. The Craft Agent commands still use /workspace as you can have multiple workspaces pointing towards the same Craft Space, hence the distinction, but the UI displays “Space” to match Craft’s terminology.

​
Understanding Spaces

A space connection in Craft Agents represents a connection to a Craft space. Each space has:
  • Its own MCP connection to your Craft documents
  • Separate conversation history
  • Independent sub-agent configurations
  • Stored credentials for that space’s services

​
Adding a Space

During initial setup, you connect your first space automatically. To add more: 
> /workspace add
This walks you through:
  1. Entering a name for the space
  2. Entering the Craft MCP URL for that space
Craft space picker coming soon - for now you’ll need the MCP URL from your Craft space.

​
Switching Spaces

View your connected spaces: 
> /workspace
 Select Space (Current: Personal Notes)
Available:
  • Personal Notes (active)
  • Work Projects
  • Shared Team Space
  + Add new space
Switch to a different space: 
> /workspace Work Projects
Switched to Work Projects
Or use the CLI flag when starting: 
craft -w "Work Projects"

​
Managing Spaces

use the following key commands in /workspace menu 
a add | r rename | d remove
Removing a space deletes its local configuration and conversation history. Your actual Craft space and documents are not affected.

​
Space-Specific Configuration

Each space maintains its own:
DataDescription
Conversation historyChat history is per-space
Sub-agentsAgents defined in that space’s Agents folder
API credentialsKeys for services used by that space’s agents
Session stateResumed conversations stay within their space

​
Use Cases

Keep your personal notes separate from work documents. Switch contexts without mixing conversations or accidentally accessing the wrong documents.
Consultants and freelancers can set up separate spaces for each client, with dedicated agents and API connections per project.
Connect to shared Craft spaces for team collaboration while maintaining your personal space for private notes.