Stuck? Let’s fix it.

• The panel doesn’t appear beside the SimulatorSetup1 min
  1. Boot a device in Simulator, or in Device Hub on Xcode 27.
  2. Click SimBuddy in the menu bar and choose Show SimBuddy.
  3. If the panel says No Simulator devices found, start or select a Simulator, then click Refresh devices. SimBuddy lists the devices of the Xcode you’re using.
• Touch marks or global shortcuts do nothingPermissions1 min
  1. Open System Settings › Privacy & Security › Accessibility.
  2. Turn on SimBuddy. It notices the change by itself; no restart needed.
  3. Try again. Accessibility powers touch marks in recordings and SimBuddy’s global shortcuts.
• Recordings have no Simulator sound, or show the wrong windowPermissions2 min
  1. Open System Settings › Privacy & Security › Screen Recording and turn on SimBuddy.
  2. If macOS asks, quit and reopen SimBuddy. Capture may not work until you do.
  3. The first time SimBuddy records, and now and then after that, macOS asks you to confirm screen capture. Choose Allow.
• Network conditioning changes nothingNetwork2 min
  1. Open System Settings › General › Login Items & Extensions.
  2. Under Network Extensions, in the By Category list, turn on SimBuddy. The By App switch doesn’t control it.
  3. When macOS asks to add proxy configurations, choose Allow. It asks once more if you ever switch the extension off and on.
• The Network Monitor shows no requestsNetwork1 min
  1. In the Network workspace, choose Open Network Monitor, then Relaunch with Monitor. For a Run from Xcode linked through SimBuddy Runtime, choose Capture This Run instead: nothing relaunches and the debugger stays attached.
  2. Use the app. Its URLSession requests and log lines appear as they happen.
  3. Requests your app makes without URLSession aren’t captured.
• My coding agent can’t find SimBuddy’s toolsAgents2 min
  1. Open SimBuddy’s Settings › Agents and connect your agent: Codex, Claude Code, Claude Desktop or Cursor.
  2. Restart the agent, or start a new session, so it picks up SimBuddy’s tools.
  3. Run simbuddy doctor in Terminal. It checks the bridge, the handoffs folder, Xcode and the Simulator, and says what to fix.
• The camera doesn’t show up in my Simulator appSetup3 min
  1. In SimBuddy’s menu bar menu, choose Setup › Set Up SimBuddy Runtime….
  2. Click Add to Xcode. It adds a short block to Xcode’s LLDB settings; Copy Command gives you the same change to run in Terminal instead.
  3. Stop your app and run it again from Xcode, then start the feed in the Camera workspace.
• I bought Pro, but SimBuddy still says FreePurchases1 min
  1. Open Settings › SimBuddy Pro and click Restore Purchases.
  2. Check that the App Store on this Mac uses the Apple ID you bought with.
  3. If SimBuddy says your subscription was found but isn’t active yet, wait a moment and try again.
• I’ve used today’s Free allowancePurchases1 min
  1. Open Settings › SimBuddy Pro to see what you used today. The counts reset at midnight.
  2. The panel, device management and plain screenshots are free and never count.
  3. SimBuddy Pro removes the daily limits.
• Cancel or change my subscriptionPurchases1 min
  1. In SimBuddy, open Settings › SimBuddy Pro and click Manage Subscription….
  2. Or open the App Store, click your name, then Account Settings › Subscriptions.
  3. Cancel at least 24 hours before the current period ends to stop the next renewal.
• SimBuddy froze or crashedDiagnostics2 min
  1. Open SimBuddy’s Settings › Privacy.
  2. Under Diagnostics, click Create Report… and save the file. It holds SimBuddy’s version, your Mac and macOS, the last five freezes and SimBuddy’s own log lines from the last hour, with home folders and tokens removed.
  3. Email the report to us with what you were doing when it happened. Freeze reports › Show in Finder opens every freeze SimBuddy kept.
• Remove SimBuddy completelyUninstall3 min
  1. If you set up SimBuddy Runtime, open Setup › Set Up SimBuddy Runtime… in the menu bar menu and choose Remove.
  2. Run simbuddy skill remove, and remove SimBuddy from your agents, for example with codex mcp remove simbuddy or claude mcp remove simbuddy.
  3. Quit SimBuddy and move it to the Trash.
  4. Remove the network extension in System Settings › General › Login Items & Extensions.
  5. Delete ~/Library/Containers/dev.simbuddy.SimBuddy and the SimBuddy folder in ~/Library/Group Containers. If you don’t want your captures, delete the SimBuddy folder in Documents or Downloads too.

No fix matches that yet. Write to us and we’ll help.