Skip to main content

​
gpr not found

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

​
Daemon offline in the app

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

Install the agent CLI, place any required ACP adapter beside gpr, then:
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.

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

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

​
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