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

# Workspaces

> Workspaces bind a directory on a machine to GPR execution settings.

A **workspace** is the user-facing execution identity: a directory on a paired machine where agents run.

## What it stores

| Field | Meaning |
| - | - |
| Working directory | Bound repo / project path |
| Machine | Which paired host runs it |
| Agent | Selected catalog agent id |
| Default model | Defaults to `auto` |
| Provider | Defaults to `byoa` |
| Max concurrent tasks | Defaults to `1` |
| Status | `active` or `archived` |

## Create one

```bash theme={null}
cd /path/to/repo
gpr setup
```

Pair via QR from the app. Re-running setup in the same directory reconnects; it does not duplicate.

## Affinity

Each task pins to one workspace / daemon. Keep that host online for the life of the run. If the host drops, the task moves to `waiting_for_agent` until it returns.

## Multiple workspaces

One machine can host several workspaces (different directories). Use separate workspaces when repos or agent defaults differ. See [Manage multiple machines](https://getpullrequest.com/docs/guides/manage-multiple-machines.md).

## Local state

Per-workspace daemon data lives under `~/.gpr/workspaces/<workspace_id>/`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.