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

# Workspaces

> Shared environments for installing and running agents.

A workspace is your team's shared environment. It connects to a GitHub repository and holds the agents your team has installed.

## Creating a workspace

1. Go to [app.guild.ai](https://app.guild.ai) and open your organization
2. Open the workspace selector at the top of the left sidebar
3. Click **New workspace** and give it a name

## What's inside a workspace

Each workspace contains:

* **Agents** — installed from the Agent Hub or published by your team
* **Sessions** — conversations with agents
* **Triggers** — automated agent execution via webhooks or schedules
* **Context** — background knowledge shared with all agents in the workspace

## Connecting a repository

Link a GitHub repository to your workspace so agents can access your code. Go to **Settings** in your workspace and connect a repository under **GitHub**.

## Find workspaces with the command palette

Use the command palette to quickly search for and navigate to a workspace. Press `Cmd+K` (macOS) or `Ctrl+K` (Windows and Linux) to open the palette, type or select `workspaces`, then press `Tab` to enter the workspaces scope and search by name.

## Archiving metadata

Workspaces include two optional fields that record archiving history.

| Field            | Type               | Description                                                  |
| ---------------- | ------------------ | ------------------------------------------------------------ |
| `archived_at`    | `datetime \| None` | Timezone-aware timestamp of when the workspace was archived. |
| `archived_by_id` | `UUID \| None`     | UUID of the user who archived the workspace.                 |

## Next steps

<CardGroup cols={2}>
  <Card title="Context" icon="book" href="/platform/context">
    Give agents background knowledge about your workspace.
  </Card>

  <Card title="Triggers" icon="bolt" href="/platform/triggers">
    Automate agent execution with webhooks and schedules.
  </Card>

  <Card title="Sessions" icon="message" href="/platform/sessions">
    Start conversations with agents.
  </Card>
</CardGroup>