Skip to content

Instantly share code, notes, and snippets.

@mateu
Created July 31, 2025 21:58
Show Gist options
  • Save mateu/16f90a56dd72bd7693796fefa93f1c93 to your computer and use it in GitHub Desktop.
Save mateu/16f90a56dd72bd7693796fefa93f1c93 to your computer and use it in GitHub Desktop.
Ways to debug warp terminal crashing on startup on Mac OS
Prompt> How does one debug a crash with warp terminal on startup?
Here are several approaches to debug a Warp terminal crash on startup:
## 1. Check Crash Logs
First, look for crash logs in the system logs:
# Check system logs for Warp crashes
log show --predicate 'process == "Warp"' --last 1h
# Or check Console.app for crash reports
open /Applications/Utilities/Console.app
## 2. Check Warp's Log Files
Warp stores its logs in specific locations:
# Check Warp's application logs
ls -la ~/Library/Logs/dev.warp.Warp-Stable/
# View recent log files
tail -f ~/Library/Logs/dev.warp.Warp-Stable/*.log
## 3. Reset Warp Configuration
Sometimes corrupted configuration files cause startup crashes:
# Backup and reset Warp settings
mv ~/.warp ~/warp_backup
mv ~/Library/Preferences/dev.warp.Warp-Stable.plist ~/warp_prefs_backup.plist
## 4. Safe Mode / Clean Start
Try starting Warp with minimal configuration:
# Kill any existing Warp processes
pkill -f Warp
# Start Warp from command line to see error output
/Applications/Warp.app/Contents/MacOS/Warp
## 5. Check for Conflicting Software
Some common causes of terminal crashes:
- Antivirus software interfering
- Shell configuration issues (.zshrc, .bashrc)
- Conflicting terminal multiplexers (tmux, screen)
## 6. Reinstall Warp
If other methods fail:
# Remove Warp completely
rm -rf /Applications/Warp.app
rm -rf ~/Library/Preferences/dev.warp.Warp-Stable.plist
rm -rf ~/Library/Application\ Support/dev.warp.Warp-Stable/
rm -rf ~/Library/Logs/dev.warp.Warp-Stable/
# Then reinstall from the official website
## 7. Contact Support
If the crash persists, gather debug information for Warp support:
- Crash logs from Console.app
- System information (`system_profiler SPSoftwareDataType`)
- Warp version information
Would you like me to help you run any of these diagnostic steps to identify what's causing your Warp terminal to crash on startup?
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment