Skip to main content
A workspace is a directory on your machine that GPR can run agents in. gpr setup creates that workspace, installs a startup service, and shows a QR code for pairing.

​
Prerequisites

  • gpr installed (Install GPR)
  • GPR mobile app signed in
  • The repo directory you want agents to use

​
Pair

From the repo root (or any directory you want bound):
Or pass a path:
Then in the app:
  1. Open Settings
  2. Open Connections / add a connection
  3. Scan the QR code from gpr setup
The QR payload includes the server URL, a short-lived pairing token, and the daemon id.

​
Confirm the daemon is online

You should see the workspace online in the app after the websocket connects.

​
Useful flags

Regenerates pairing credentials.
Overrides the backend websocket URL. For local backend development the daemon uses ws://localhost:8000/gpr/ws/daemon when GPR_ENV is dev, development, or local.

​
Re-running setup

Re-running gpr setup in an already configured directory reconnects that workspace. It does not create a duplicate.

​
Next

Connect GitHub so GPR can open and enrich pull requests.