Troubleshooting Guide¶
Quick fixes and recovery commands for common issues.
Quick Fixes¶
Emergency Recovery¶
# Window manager breaks
killall yabai skhd
brew services restart yabai
brew services restart skhd
# Terminal broken
/Applications/Ghostty.app/Contents/MacOS/ghostty
# Tmux unresponsive
tmux kill-server
tmux new-session
# Neovim stuck
:qa! # Force quit all
pkill nvim # From another terminal
Service Restart¶
# Restart all window management
skhd --restart-service
yabai --restart-service
# Check status
brew services list | grep -E "(yabai|skhd)"
Troubleshooting by Category¶
- Window Management - Yabai tiling, SKHD shortcuts, spaces
- Terminal - Tmux sessions, Ghostty, colors
- Neovim - Plugins, LSP, config errors
- AI Tools - CodeCompanion, Copilot, database AI
- Performance - Slow startup, memory, system recovery