An app by Andrew MastracchioVisit the main site

DevBench HelpSettings and reference

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.

Check on sync

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.

Resolve a conflict

The share sheet says No Apps Yet

Open DevBench and add an app first. If a capture says its attachments will sync when you open DevBench, open the app once to finish.

DevBench isn’t in the share sheet

Scroll to the end of the row of apps in the share sheet, tap More, and turn on DevBench. On Mac, choose Edit Extensions… in the Share menu and turn on DevBench.

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.

What you allow

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.

Still stuck?

Send me a message with your device, OS and DevBench version, and what happened.

Contact support