Workspaces

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 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.

​

Next steps