Desktop App — Troubleshooting

macOS: "InsightWorker can't be opened because Apple cannot verify it"

The current build is unsigned (no Apple Developer ID Application certificate). This is a one-time-per-version dialog. To bypass:

Right-click InsightWorker.app → Open
Click Open in the warning dialog

Subsequent launches won't prompt.

If you've already double-clicked and macOS quarantined it:

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

App keeps opening new windows

Fixed in a recent build. If you're on an older version, upgrade. If you're on the current build and still see this, make sure no zombie process is hanging:

pkill -f InsightWorker  # macOS / Linux
# Then relaunch

"Bedrock credentials not found"

You configured AWS SSO and your session expired. Open a terminal and:

aws sso login --profile <your-profile>

Then fully quit and reopen the desktop app (Cmd+Q not just close window). The app reads AWS credentials at process start.

Schedules don't fire

Two failure modes:

Daemon not running — open Schedules pane, check status indicator at the top. If "stopped", click Start daemon.
Cron expression wrong — click Dry-run on the schedule. If "next fires" looks far away or never, fix the cron expression. See workflows-and-scheduling/cron-syntax.md.

App crashes on launch

Check the app log:

OS	Path
macOS	`~/Library/Logs/InsightWorker/main.log`
Windows	`%APPDATA%\InsightWorker\logs\main.log`
Linux	`~/.config/InsightWorker/logs/main.log`

The most common crash cause is a malformed ~/.insightworker/.env. Try:

mv ~/.insightworker/.env ~/.insightworker/.env.bak

Then relaunch — the app should start with the onboarding wizard.

Auto-update fails

If Check for Updates says "update available" but download fails:

Check for VPN / firewall blocking GitHub Releases (the update channel)
Try downloading the new installer manually from the releases page

Editor pane is blank / white

The Monaco editor occasionally fails to load on first launch behind certain network proxies (it fetches CDN-hosted assets). Workaround: View → Reload (Cmd+R).

If reload doesn't fix it, your network is blocking the Monaco asset fetch; we have an issue tracking offline-Monaco bundling.

Logs

What	Where
App main process	`~/Library/Logs/InsightWorker/main.log` (macOS)
Renderer console	View → Toggle Developer Tools
Agent session transcripts	`~/.insightworker/sessions/<timestamp>.jsonl`