If the Executor desktop app is crashing, won't open, or shows a blank window, work through these in order — most crashes are fixed by step 1.
1. Update to the latest version
Many crashes are already fixed in a newer build.
- If the app opens at all: open the Executor menu → Check for Updates…, install, and restart.
- If it won't open: download the latest from Releases and install over your existing copy. Your data is safe — it lives in
~/.executor and reinstalling never touches it.
- Don't downgrade. An older version running against data a newer one already upgraded is a known crash.
2. Quit and reopen
If a crash left the app in a bad state, a clean relaunch (and the update it may stage on quit) often clears it.
3. Reset data (if it still won't start)
A damaged data directory makes startup fail every time, and updating can't fix that. The crash/startup screen has a Reset data option — it moves your current data into ~/.executor/backups/ (it is not deleted, and you can restore it by copying the files back) and starts fresh.
4. Still crashing? Tell us
Open a Desktop app crash report.
The fastest path: open the Executor menu → Export Diagnostics… (or Report a Problem…) and attach the zip — it has the version, OS, and logs we need, and no secrets.
Prefer to attach the log file directly?
- macOS:
~/Library/Logs/Executor/main.log
- Windows:
%APPDATA%\Executor\logs\main.log
- Linux:
~/.config/Executor/logs/main.log
Please don't attach anything from ~/.executor — that's where your data and secrets live.
If the Executor desktop app is crashing, won't open, or shows a blank window, work through these in order — most crashes are fixed by step 1.
1. Update to the latest version
Many crashes are already fixed in a newer build.
~/.executorand reinstalling never touches it.2. Quit and reopen
If a crash left the app in a bad state, a clean relaunch (and the update it may stage on quit) often clears it.
3. Reset data (if it still won't start)
A damaged data directory makes startup fail every time, and updating can't fix that. The crash/startup screen has a Reset data option — it moves your current data into
~/.executor/backups/(it is not deleted, and you can restore it by copying the files back) and starts fresh.4. Still crashing? Tell us
Open a Desktop app crash report.
The fastest path: open the Executor menu → Export Diagnostics… (or Report a Problem…) and attach the zip — it has the version, OS, and logs we need, and no secrets.
Prefer to attach the log file directly?
~/Library/Logs/Executor/main.log%APPDATA%\Executor\logs\main.log~/.config/Executor/logs/main.logPlease don't attach anything from
~/.executor— that's where your data and secrets live.