What is a Workspace?
- Project Isolation:
Each workspace is a siloed environment, with its own files, chat history, prompts, integrations, and users. - Custom Context:
Set custom prompts and upload relevant docs/files to guide the AI’s responses within that workspace. - Smart URL Routing:
Workspace names appear in your URL for fast switching (e.g./swarm-labs--c2637be2-ead1-49b2-91c6-057726af3af6).
Key Features
-
Workspace-Aware AI
All chats and agent actions are scoped to the current workspace—so your instructions, files, and context are always relevant. -
Workspace Switcher
Instantly switch between workspaces from anywhere in the app. Each workspace loads its own custom context and assets. -
Workspace Customization
- Name and Icon: Make it easy to recognize.
- Prompt: Set a unique prompt for the AI within this workspace—tailor answers to the project’s tone, style, or requirements.
- Files: Upload project-specific files (PDFs, DOCX, etc.) to be used as references in chats and agent tasks.
-
Team Collaboration
- Team Settings: Invite collaborators to your workspace.
- Permission Management: Decide who can view, edit, or administer workspace content.
- Resource Allocation: Allocate AI resources or integrations per workspace.
- Integration Limits: Manage and cap external app integrations for security or cost control.
- Audit Settings: Enable activity logs and audits for compliance or transparency.
Workspace Configuration
1. Add Files to Workspace
- Upload files (PDFs, DOCs, etc.) directly to your workspace.
- Files are accessible by all agents and users in the workspace.
- Remove, replace, or manage files at any time.
- File upload supports multiple formats and tracks upload status.
2. Set Workspace Prompt
- Set a unique AI prompt for each workspace.
- Guide the AI’s responses—define the tone, style, or rules for chats in this project.
- Prompts are saved per workspace and can be changed any time.
3. Manage Team & Permissions
- Add or remove team members from a workspace.
- Assign roles (admin, editor, viewer).
- Control which integrations and files each member can access.
- Team settings and user management keep workspaces secure and collaborative.
Workspace URLs
- Every workspace gets a unique URL, including a prefix for the workspace name.
- Example:
/swarm-labs--c2637be2-ead1-49b2-91c6-057726af3af6 - Makes switching and bookmarking fast and intuitive.
- Example:
Why Use Workspaces?
- Stay Organized: Keep different clients, teams, or projects cleanly separated.
- Contextual AI: The AI always has access to the right files and prompts—no accidental context bleed.
- Better Collaboration: Team up with others while controlling access and customizing the AI’s behavior for each scenario.
- Granular Control: Assign resources, limit integrations, and audit activity—per workspace.
Getting Started
-
Create a Workspace:
Name your workspace and add a description or prompt if needed. -
Upload Files:
Add any project docs, references, or assets you’ll need. -
Customize Prompt:
Set how you want the AI to behave within this workspace. -
Invite Team Members:
Grant access and assign permissions. -
Switch and Work:
Use the workspace switcher or URL to jump between projects instantly.
Pro Tip:
You can move chats or tasks into different workspaces at any time. Each workspace remembers its own history, files, and settings.
Workspaces are your command center for multi-project productivity—context-rich, customizable, and built for how real teams work.

