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 issues, SKHD shortcut conflicts, and spaces configuration.

Terminal Tmux session problems, Ghostty issues, and color/rendering fixes.

Neovim Plugin failures, LSP errors, and Neovim config troubleshooting.

AI Tools CodeCompanion, Supermaven, and miudb database AI issues.

Performance Slow startup, high memory usage, and system recovery steps.