Troubleshooting

Troubleshooting

"ShuttleX isn't allowed to control …"

macOS needs permission for ShuttleX to drive your terminal.

• Automation: System Settings → Privacy & Security → Automation → enable the terminal under ShuttleX.
• Accessibility (only for Terminal.app "new tab"): System Settings → Privacy & Security → Accessibility → enable ShuttleX.

Gatekeeper blocks the app

The app is ad-hoc signed, not notarized. Approve it once:

xattr -dr com.apple.quarantine /Applications/ShuttleX.app

or System Settings → Privacy & Security → "Open Anyway".

The app icon is stale in Finder/Dock

macOS caches icons aggressively. Refresh with:

killall Dock Finder

(or log out and back in).

"No servers found" after import

Make sure the spreadsheet has a header row with recognizable column names (User, Server DNS, Server IP, Cluster, Stage) or the columns in that fixed order. Rows whose connection fields contain spaces or shell symbols are skipped on purpose (see Table import → Safety).

Launch at login doesn't stick

Run the app from /Applications (not from the build folder or the Downloads zip).

Nothing happens / wrong terminal opens

Check the selected terminal in the dropdown footer or Settings. ShuttleX only lists terminals that are installed; if yours isn't listed, install it or pick another.