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

# Troubleshooting

> Common GPR setup and runtime failures with concrete fixes.

## `gpr` not found

```bash theme={null}
echo "$PATH"
ls ~/.local/bin/gpr
```

Open a new shell, or add `~/.local/bin` to `PATH`. Re-run the installer if the binary is missing:

```bash theme={null}
curl -fsSL https://getpullrequest.com/install | bash
```

## Daemon offline in the app

```bash theme={null}
gpr status
gpr doctor
gpr reconnect
gpr logs -f
```

Check network access to `wss://api.getpullrequest.com/gpr/ws/daemon`. After laptop sleep, `gpr reconnect` or `gpr restart` often clears a stuck socket.

## Pairing QR expired

Pairing tokens are short-lived (on the order of minutes). Run `gpr setup --force` and scan again.

## No agents ready

```bash theme={null}
gpr discover
which cursor-agent claude codex
```

Install the agent CLI, place any required ACP adapter beside `gpr`, then:

```bash theme={null}
gpr restart
gpr discover
```

Service-managed daemons may not inherit your interactive shell `PATH` or exported API keys. Install tools in standard locations, then `gpr restart`. To pass env into the agent process (keys, base URLs, proxies), use [agents.json](/docs/reference/agents-json).

## Agent works in a terminal, not in GPR

The daemon does not source `.zshrc`, `.bashrc`, or PowerShell profiles. Auth that works after `source ~/.zshrc` is invisible to LaunchAgent / service-managed `gpr`.

Put the same variables on the agent in `~/.gpr/agents.json`, then `gpr restart`. If you override a catalog id such as `claude`, include `command` as well. Env-only blocks fail.

## Task stuck in waiting for machine

Host went offline. Bring the daemon back, then wait for auto-resume from checkpoint. See [Handle task failures](/docs/guides/handle-task-failures).

## Task failed during testing

Open task activity for the failing command output. Fix tests locally if needed, then **Rerun** from the app.

## Permission prompts never appear

For unattended tasks, more tool kinds are auto-approved (including `execute`). Mutating `edit` / `delete` / `move` should still reach you unless you widened auto-approve via env vars. See [Permissions](/docs/security/permissions).

## GitHub PR not opening

Confirm GitHub is connected under **Settings → Connections** and the workspace repo is bound. Local commits can still exist on the machine without a host PR.

## Update the daemon

```bash theme={null}
gpr update
gpr --version
```