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

# Overview

> How GPR pieces fit together: phone, backend, daemon, agents, and git.

GPR is a control plane for coding agents that run on machines you own.

## Runtime shape

```text theme={null}
Flutter app  --HTTPS-->  FastAPI (REST)
Flutter app  --WSS---->  hub / relay  <--WSS--  gpr daemon
                              │
                         optional HTTPS to GitHub / Jira / Slack
                              │
gpr daemon  --ACP stdio-->  Cursor / Claude / Codex / …
gpr daemon  --git-------->  local worktrees
```

| Piece | Role |
| - | - |
| Mobile app | Board, chat, review, settings |
| Backend | Auth, task queue, relay, integrations |
| `gpr` daemon | Pairing, ACP host, git worktrees |
| Coding agent | Writes and edits code on the machine |

## Core objects

| Object | What it is |
| - | - |
| [Machine](https://getpullrequest.com/docs/how-gpr-works/machines.md) | Paired computer running the daemon |
| [Workspace](https://getpullrequest.com/docs/how-gpr-works/workspaces.md) | Directory bound to a machine; where tasks run |
| [Task](https://getpullrequest.com/docs/how-gpr-works/tasks.md) | Board item with status, phase, and checkpoint |
| [Agent session](https://getpullrequest.com/docs/how-gpr-works/agent-sessions.md) | Live ACP session tied to a task or chat |
| [Pull request](https://getpullrequest.com/docs/how-gpr-works/pull-requests.md) | Review artifact; GitHub is source of truth when connected |

A task pins to one workspace. Do not let a second host take over the same task.

## BYOA by default

Workspaces default to bring-your-own-agent (`provider: byoa`). Agents and credentials live on your machine. The cloud orchestrates; it does not replace your local toolchain.

## Enrichments vs core

Core features work without OAuth: board, sessions, local git, merge-check from the daemon.

[GitHub](https://getpullrequest.com/docs/integrations/github.md), [Jira](https://getpullrequest.com/docs/integrations/jira.md), and [Slack](https://getpullrequest.com/docs/integrations/slack.md) are optional enrichments. They sync issues, open host PRs, and add metadata. They never replace local git results.


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