> ## 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](/docs/guides/manage-multiple-machines).

## Local state

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