> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twin.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspaces

> Organize agents that collaborate and share context

Organise agents into workspaces where they collaborate and share context, so you can tackle complex workflows while keeping each agent focused and reliable.

## What Is a Workspace?

A workspace is where your agents live. Every agent in Twin exists inside a workspace — you can't create an agent outside of one.

A workspace can contain a **single agent** or **as many as you need**. When you have multiple agents, they all share the same context — making it easy to build multi-agent workflows where each agent handles a specific part of the job.

<CardGroup cols={3}>
  <Card title="Unlimited Agents" icon="robot" color="#F4D03F">
    Create as many agents as you need inside a workspace
  </Card>

  <Card title="Shared Context" icon="share-nodes" color="#F4D03F">
    Agents in the same workspace can collaborate and share knowledge
  </Card>

  <Card title="Focused & Reliable" icon="bullseye" color="#F4D03F">
    Keep each agent focused on a single task for better results
  </Card>
</CardGroup>

## The Orchestrator

To create, delete, or modify agents inside a workspace, use the **Orchestrator** — the chat on the left side of the screen.

<Frame>
  <img src="https://mintcdn.com/twinlabs/32bkTaA33ltG-5t7/images/orchestrator-example.png?fit=max&auto=format&n=32bkTaA33ltG-5t7&q=85&s=bbe69947a7c4cf83c2ea12397c17007f" alt="The Orchestrator (left) managing a workspace while an agent builds on the right" width="1024" height="686" data-path="images/orchestrator-example.png" />
</Frame>

The Orchestrator has full context on everything in your workspace. You can talk to it to:

<CardGroup cols={2}>
  <Card title="Create new agents" icon="plus" color="#F4D03F">
    Describe what you need and the Orchestrator will build a new agent for you
  </Card>

  <Card title="Modify existing agents" icon="pen" color="#F4D03F">
    Ask to update goals, change behavior, or add new steps to any agent
  </Card>

  <Card title="Delete agents" icon="trash" color="#F4D03F">
    Remove agents you no longer need
  </Card>

  <Card title="Coordinate workflows" icon="diagram-project" color="#F4D03F">
    The Orchestrator knows about all your agents, so it can help you design multi-agent workflows
  </Card>
</CardGroup>

The Orchestrator is also **proactive** — if it thinks your workflow would benefit from splitting into multiple agents or creating a new one, it will suggest it on its own.

<Tip>Think of the Orchestrator as the manager of your workspace — it sees everything, can act on any agent, and will propose changes when it spots opportunities to improve your setup.</Tip>

## Multiple Workspaces

<CardGroup cols={2}>
  <Card title="Separate projects" icon="folder-open" color="#F4D03F">
    Keep client work, internal tools, and experiments isolated from each other.
  </Card>

  <Card title="Team boundaries" icon="shield-halved" color="#F4D03F">
    Give different teams access to only the agents they need.
  </Card>
</CardGroup>

<Note>
  Workspaces are currently **independent** — agents in one workspace can't directly connect to or communicate with agents in another workspace.
</Note>

<Warning>
  **Connected accounts are workspace-scoped.** Each workspace can only connect to one account per service (e.g., one X/Twitter account, one Gmail account). If you need to manage multiple accounts for the same service, create a separate workspace for each.

  Multi-account management — including managing accounts on behalf of your clients — is coming soon.
</Warning>

However, Twin maintains a **User Memory** that carries context across workspaces. When you create a new workspace, Twin already knows your preferences, tools, and patterns from previous workspaces — so you don't start from scratch every time.

## Get Started

<Card title="Open Your Workspace" icon="arrow-right" href="https://builder.twin.so/" color="#F4D03F">
  Sign in to Twin and start building
</Card>
