Duc's Digital Workspace¶

Welcome to the comprehensive documentation for this modern macOS development environment. Quick setup, configuration guides, and troubleshooting for all tools.

Getting Started¶

• Installation Guide - Complete setup from scratch
• Quick Reference - Essential commands and shortcuts
• Troubleshooting - Common issues and solutions

Core Tools Documentation¶

Terminal & Multiplexing: - Tmux Setup - Terminal multiplexer configuration - Atuin - Shell history and sync

Window Management: - SKHD Configuration - Hotkey daemon setup

Editors & IDE: - Neovim Configuration - AstroNvim v5 setup

Development Workflows: - Zen Mode - Distraction-free coding with Tmux - AI Workflows - Best practices for AI-assisted coding

Quick Help¶

Common Commands¶

# Restart services
brew services restart yabai
brew services restart skhd

# Reload configurations
tmux source-file ~/.tmux.conf
source ~/.zshrc

# Update plugins
:Lazy sync  # In Neovim
prefix + I  # In Tmux

Emergency Recovery¶

# If window manager breaks
killall yabai skhd
brew services restart yabai

# If terminal breaks
/Applications/Ghostty.app/Contents/MacOS/ghostty

Documentation Structure¶

1. Installation - Setup procedures and requirements
2. Quick Reference - Shortcuts and common commands
3. Tool-Specific Guides - Detailed configuration docs
4. Troubleshooting - Debug and fix common issues
5. Workflows - AI integration and daily patterns

File & Links¶

• Codebase Summary - Project structure overview
• Main README - Feature highlights and badges
• Neovim Docs - AI tools and plugins