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

# Workspaces for organising threat models

> Workspaces organise your threat models by project, team, or repository. Each workspace has its own members, access controls, and threat model history.

Workspaces organise your threat models by project, team, or repository. Each workspace has its own members, access controls, and threat model history.

<Frame>
  <img src="https://mintcdn.com/oplane-6a173d70/jwR0xubu7PkQElvJ/images/workspaces/overview.webp?fit=max&auto=format&n=jwR0xubu7PkQElvJ&q=85&s=1701569a90497c69d0490d18d7a6ae04" alt="Oplane Workspaces overview" width="3246" height="1866" data-path="images/workspaces/overview.webp" />
</Frame>

## Workspace Types

When creating a workspace, choose the type that matches your workflow:

#### Agent Workspace

Run threat modeling locally with your coding agent via MCP. Analyse any repository and upload results to Oplane. Best for developers running threat models from their IDE (Cursor, GitHub Copilot, Claude Code, etc.).

#### Managed Workspace

Let Oplane model threats in the cloud and continuously analyse changes across pull requests. Tied to a specific Git repository for automated PR/MR reviews.

## Creating a Workspace

### Agent Workspace

To create an Agent Workspace, click **+ Workspace** in the top right corner and select **Agent Workspace**:

1. Enter a name for the workspace (e.g. your project name)
2. Add an optional description
3. Configure access — add team members by name or email
4. Set general access (restricted or open to the organisation)
5. Click **Create**

<Frame>
  <img src="https://mintcdn.com/oplane-6a173d70/jwR0xubu7PkQElvJ/images/workspaces/create-agent.webp?fit=max&auto=format&n=jwR0xubu7PkQElvJ&q=85&s=b4265c7a34c75af202b3af1e89b655bc" alt="Create an Agent Workspace" width="1500" height="858" data-path="images/workspaces/create-agent.webp" />
</Frame>

### Managed Workspace

To create a Managed Workspace, select **Managed Workspace** and link it to a Git repository:

1. Select your organisation from the dropdown
2. Search for and select the repository you want to connect
3. Click **Create**

<Frame>
  <img src="https://mintcdn.com/oplane-6a173d70/jwR0xubu7PkQElvJ/images/workspaces/create-managed.webp?fit=max&auto=format&n=jwR0xubu7PkQElvJ&q=85&s=dc4a0c34b16fee239aed6acf1790abd7" alt="Create a Managed Workspace" width="958" height="936" data-path="images/workspaces/create-managed.webp" />
</Frame>

<Note>
  Managed Workspaces require a connected Git provider (GitHub or GitLab). If you haven't connected one yet, see [Connect GitHub](/connect-github) or [Connect GitLab](/gitlab-setup).
</Note>

## Managing Workspaces

From the Workspaces page you can:

* **Star** workspaces to pin them at the top of your list
* **Search** across all workspaces by name
* **Switch views** between grid and list layout
* **Filter** by starred workspaces only

Each workspace card shows the workspace type, number of threat models, and member count at a glance.