Skip to content

Reference · Troubleshooting

Get back to building.

Fixes for the problems people hit first: installing, signing in, the plan screen, updates, coding agents and voice.

The app won’t install or open

  • Mac: SwarmPane needs macOS 13 or later. Drag it to Applications and open it from there. The first time, macOS asks whether to open an app downloaded from the internet: choose Open.
  • Windows: SmartScreen’s “Windows protected your PC” appears because the installer isn’t code-signed yet. Choose More info, then Run anyway. If Smart App Control blocks it without offering Run anyway, contact support.
  • Linux AppImage won’t start: make it executable with chmod +x, or allow executing it as a program in its Properties. “Cannot mount AppImage” means FUSE 3 is missing: install fuse3, run it with --appimage-extract-and-run, or use the .deb.
  • Linux .deb: apt refuses it on systems older than glibc 2.34, such as Ubuntu 20.04 or Debian 11. They aren’t supported.
  • Ubuntu 24.04 and later: the AppImage runs without Chromium’s sandbox and says so. Install the .deb to run sandboxed.

Desktop sign-in isn’t completing

  • The code expired: each code works once, for 10 minutes. When the app says the sign-in expired, choose Sign in or create account for a new code.
  • Check that the code in the browser matches the one in the app before you approve, and approve only a code you started.
  • Approve with the account that has your plan. Not you? on the approval page switches accounts.
  • “Too many connection attempts”: wait a few minutes, then try again.
  • “Reconnect to SwarmPane”: the app couldn’t reach SwarmPane’s service to check your plan. Check your connection, then choose Check account again.

The app says “Choose a SwarmPane plan”

The app is signed in, but that account has no active plan. Start your plan in My account, or check that the app signed in with the account you paid with. Then choose “I’ve subscribed — check again” in the app.

Paid and it still asks? SwarmPane 1.0.1 may not notice by itself that your plan started. Choose “I’ve subscribed — check again”, or quit and reopen SwarmPane. Right after checkout, Stripe can take a minute to confirm the payment.

Updates aren’t arriving

  • Choose Check now in Settings → General → Updates. It says how your copy updates and whether a new version is ready. A ready update installs when you quit, or with Restart & install.
  • Mac: SwarmPane has to run from Applications. A copy opened from the disk image can’t update itself, and Settings says so.
  • Mac or .deb on 1.0.0: those can’t update themselves. Install 1.0.1 once by hand.
  • Linux .deb: updates are by hand for now. Install each new .deb from Downloads with sudo apt install.
  • Windows: only copies installed with the installer update themselves. Install SwarmPane from Downloads.

An agent is missing or returns an error

  • Check that the CLI is installed and runs in your normal terminal. Settings → Agents shows what SwarmPane found, and an install command for each CLI that’s missing.
  • Installed it while SwarmPane was open? On a Mac, quit and reopen SwarmPane: it reads your shell’s PATH when it starts.
  • Sign in through the provider and confirm that the account can run a request.
  • Select the intended account in the workspace.
  • Read the exact provider error. Authentication, model access, and usage limits have different remedies.
  • Windows: Git features need Git for Windows.

Voice doesn’t start or produces no text

  • Voice needs the Mac or Windows app and Pro; a Pro trial that is still running counts. If the app says SwarmPane Voice comes with Pro, your plan is Starter.
  • Microphone access is off: in System Settings → Privacy & Security → Microphone, turn on SwarmPane Voice, then try again. Settings → Voice & Dictation shows the permission, with Check again.
  • The shortcut does nothing: another app may use the same keys. Choose a different shortcut in Settings → Voice & Dictation.
  • Without cloud voice (offline, signed out or out of minutes), check that Whisper is set up on your Mac: a downloaded model and whisper.cpp.
  • A long dictation stopped by itself: cloud voice takes up to 2 minutes at a time. Dictate again to add more, or set up Whisper on your Mac for longer recordings.
  • Voice Anywhere types nothing: turn on SwarmPane Voice in System Settings → Privacy & Security → Accessibility. It never types into password fields.
  • SwarmPane’s Dock icon disappears while you dictate: that was a 1.0.0 bug, fixed in 1.0.1.
  • Check the selected destination and recording status before retrying.

Share a useful report

Include your app version (Settings → General → What’s new names it), your operating system, the steps to reproduce, and what you expected. Settings → General → Export diagnostics saves a file you can attach: it has no conversations, and secrets are removed. Remove credentials and private project content from anything else you share.

Need a hand with your setup?TroubleshootingContact