Troubleshooting
If something isn’t working, start here.
Sync isn’t working
- Choose the cloud button to see what DevBench says is wrong, then choose Sync Now (⌥⌘R on Mac).
- Make sure the device is signed in to your Apple Account and iCloud is on for DevBench, in Settings (System Settings on Mac).
- Screen Time or a device management profile can limit iCloud. DevBench then says iCloud is restricted on this device.
- If an upload looks stuck, choose Retry Upload in the sync sheet. It stops the upload and starts it again, and nothing is lost.
- If one device is missing things the others have, go to Settings ▸ Advanced on that device and choose Download Everything Again.
DevBench says iCloud storage is full
Free up iCloud storage or upgrade your plan, then choose Sync Now. Your changes wait on the device in the meantime.
DevBench says the iCloud account changed
Your data is still on this device. To copy it to the account that’s signed in now, go to Settings ▸ Advanced and choose Upload All Data to iCloud. Do the same if DevBench says its data was removed from iCloud.
A conflict keeps showing
Conflicts stay until you choose which version to keep. Open Conflicts in the sidebar and resolve each one.
A capture didn’t show up
Captures from the share sheet are brought in when DevBench opens. If one is missing, go to Settings ▸ Advanced ▸ Import Share Sheet Captures and choose Import Now. A capture made before you had any apps waits until you add one.
An agent can’t connect
- Check that Allow Coding Agents to Connect is on in Settings ▸ Coding Agents, then choose Test Connection.
- Start a new session with your agent after adding DevBench. Agents load their servers when a session starts.
- If the status reads “On, but helper-launched agents can’t find it”, turn Allow Coding Agents to Connect off and on again. Agents connecting over HTTP with the token still work.
- If DevBench asks you to approve it under System Settings ▸ General ▸ Login Items, do that for Open DevBench at Login.
- If Linked Projects says some files run a helper that’s missing or out of date, choose Update All.
- If Test Connection says “The server refused the access token (401)”, choose New Token… under Connect Manually and give HTTP agents the new one.
An agent can read but not change anything
- In Settings ▸ Coding Agents, find the agent under Agents and choose Allow.
- If it reads Turned off, it can’t read either. Choose Allow to let it back in.
- If the agent says an item is locked as history, the item is released or in App Review. Ask the agent specifically to change it anyway, or choose Edit on the item yourself.
An agent can’t record a build or release
Check What Agents Can Do in Settings ▸ Coding Agents. With Recording Builds set to Never, agents can’t record builds. With Ask Each Time, a request you don’t answer within two minutes isn’t recorded. Recording that a build was sent to TestFlight, submitted or released needs Allow Release Moves.
DevBench can’t read the project folder
- Choose the folder that contains the Xcode project, not a folder inside it.
- If DevBench says it couldn’t link or keep access to the folder, choose it again in App Info ▸ Project Folder.
- A project in iCloud Drive has to be confirmed once on each device.
- If Use Icon from Project says no app icon was found, choose the icon file yourself with Choose Icon File…
An attachment won’t add
- Each file can be up to 250 MB.
- Folders can’t be attached as they are. Compress the folder first.
- A file that reads Waiting for iCloud hasn’t downloaded to this device yet. Leave DevBench open on a good connection.
Spotlight or a widget is out of date
In Settings ▸ Advanced, choose Rebuild Spotlight Index or Reload Widgets.
DevBench couldn’t open your data
If DevBench opens to “Couldn’t Open Your Data”, choose Restore from Backup… and pick your most recent backup. Then send me a message, with your logs if you can.
Sending logs with a bug report
DevBench keeps a diagnostic log on your device for 14 days. It includes technical events and some file names, but not the titles, notes or contents of your items. Open Settings ▸ Advanced ▸ View Logs (Help ▸ Diagnostics… on Mac), choose Export Diagnostics, and attach the file to your support message.
- The logs stay on your device unless you choose to share them.
