Troubleshooting
Find the failing layer before you retry, switch accounts, or touch session data.
Checked against the source on 17 September 2026
On this page
A task will not start
- Read the ChatGPT account state, the usage limits, and any pending approval request.
- Look at the queue. A held entry shows why it is held and offers retry and remove.
- Read the visible error before you send a second copy of the instruction.
A message in the queue is safely with the desktop. A message in the timeline reached the agent, so inspect that run. When neither shows the message after a reconnect, keep the original error text for your report.
The phone cannot reach the workspace
| Check | Action |
|---|---|
| Account | Both apps must use the same PlanToCode account. Matching ChatGPT accounts do nothing for discovery. |
| Region | Select the same server region on both devices. Changing the region signs the old session out. |
| Remote access | Turn on Allow Remote Access on the desktop under Settings → Connections. |
| Computer state | Open the desktop app and wake the computer. A sleeping laptop drops its relay connection; the server shows the desktop as reconnecting for 90 seconds and then as offline. |
| Network and readiness | Read the connection banner on the phone and use its reconnect action. |
A bundled tool is not available
| Tool | Check |
|---|---|
| Browser control | The Browser Bridge extension is installed and enabled in Chrome 120 or later, Browser Bridge is enabled under Settings → Connections, and PLANTOCODE_DISABLE_BROWSER_BRIDGE is not set. Without a connected extension the status action returns bridge diagnostics. For incognito research, allow the extension in incognito windows. |
| Speech and video | A Gemini API key is saved under Settings → API Keys. The tools appear on the next run after saving. |
| Push alerts from the agent | Desktop and phone notifications are enabled under Settings → General, the phone has alerts allowed, and the desktop shows its relay connection as online. |
| HTML documents | The link in the chat opens the preview. If a document is missing, the session folder on the desktop was removed or the desktop is offline for the phone. |
History is loading or a source is missing
A live connection and a history read are separate steps, so a connected banner with an empty timeline points at the read. Use Retry loading in the timeline. When an attached external session reports a missing source, Choose source file lets you select the intended file yourself. PlanToCode does not swap in a similar file from another profile.
An attached Zstandard-compressed transcript loads read-only: history shows, and sends are blocked until you decompress it and attach the JSONL. Keep the original file and check the selected source identity when you repair a link.
Write a report someone can reproduce
App and version:
Desktop OS / iOS or Android version:
Selected server region:
Steps to reproduce:
Expected behavior:
Actual behavior and visible error:
Approximate time:
Did the same action work on desktop?
Relevant screenshot or bounded log excerpt: