GreatPingTroubleshooting
What to check when an alert does not arrive, rings too often, or the app shows something unexpected.
Start on the computer:
greatping doctor --verbose
greatping testdoctor runs each installed hook with a test event and reports hooks that are broken, outdated or have never run; doctor --fix repairs them. test sends a test notification to every device and reports, for each, whether Apple or Google accepted it. Then look at the phone: "accepted" is as far as a server can know.
No alert for an agent's prompt
- You answered within the delay. While you use the computer, alerts wait 30 seconds by default. A prompt closed in time never reaches the phone. To test, leave the prompt open longer, or step away from the computer for two minutes.
- The agent was already running. Restart the agent session after
greatping setupso it loads the hooks. - Codex hooks are not trusted yet. Open
/hooksin Codex once and trust them. The app shows this on the computer's screen under Agents. - The agent decided on its own. In Claude Code's auto mode, permissions that are granted automatically never ask you, so nothing is sent.
- The computer is paused.
greatping statusshows it;greatping resumeends it. In the app, the computer's screen shows Pause Alerts. - This device is Off for the computer, paused, in quiet hours, or has that alert type turned off. The alert is in the inbox, marked Muted if the device is Off. Check the computer's Who Gets Alerts and Settings › Notifications.
No notifications on the phone at all
Send a test from the app: Settings › Devices › this device › Send Test Notification.
- Notifications are off for GreatPing. Settings › Notifications › GreatPing › Allow Notifications. Turn on Lock Screen and Banners too.
- A Focus is on (Do Not Disturb, Sleep, Work). Add GreatPing to the Focus's allowed apps, or allow Time Sensitive Notifications for GreatPing so reminders break through.
- Scheduled Summary. If GreatPing is in the summary, its notifications wait for the next summary. Take it out in Settings › Notifications › Scheduled Summary.
- The app was offloaded or not opened since a reinstall. Open it once so it registers for notifications again.
If the inbox says Notifications are off or Notifications unavailable, follow its button; it opens the right settings.
Too many notifications
- Set your extra devices to Standard or Backup instead of First, on the computer's screen.
- Turn off Finished Turns in Settings › Notifications if you only care about decisions.
- Raise Delay While Present on the computer's screen if you often answer at the keyboard just after your phone rings.
- Turn the Reminder off for a computer, or set it later.
- Set Quiet Hours for the night.
greatping test reports a refusal
The result names the device and the push service's reason. Usually opening GreatPing on that device registers it again. If it keeps failing, sign the device out and link it again.
Pairing problems
| Message | What to do |
|---|---|
| No computer is waiting with this code | Check the code, or run greatping login again for a new one. Codes last 15 minutes. |
| This code was already used | Run greatping login again. |
| The code did not match the computer | The second half was mistyped, or something changed it on the way. Nothing was paired. Run greatping login again and check the code carefully. |
| Paired with an earlier version (on the computer) | Run greatping logout, then greatping login. |
Linking a phone or tablet shows the same messages for its codes, which last 10 minutes.
"Set up GreatPing again"
The account was created by an early test version. See Your account.
"Could not verify this alert"
The app refused to show an alert because it was not sealed by a computer of your account for this device. See Alerts and questions.
"This device was added recently"
A device added in the last 72 hours cannot remove older devices or computers, or delete the account. Use an older device, or wait; the app says from when.
The app asks for a passcode I don't remember
Tap Forgot Passcode?. The device leaves the account; link it again from another device. See Passcode, app lock and security.
Still stuck
Write to support@greatping.com with:
- the output of
greatping doctor --verbose; - the version details from the app (tap the version line at the bottom of Settings to copy them);
- what you expected and what happened.
Neither contains prompt text, tokens or credentials.