docs: simplify and update documentation

- Remove nushell/sketchybar references (configs removed)
- Remove contributing section
- Add codebase-summary.md
- Simplify docs/index.md navigation
- Update temporal.md to proper stub

Author: vanducng

README.md

@@ -6,28 +6,26 @@ A comprehensive, AI-enhanced development environment for macOS featuring tiling
 ![macOS](https://img.shields.io/badge/macOS-000000?style=for-the-badge&logo=apple&logoColor=white)
 ![Neovim](https://img.shields.io/badge/NeoVim-%2357A143.svg?&style=for-the-badge&logo=neovim&logoColor=white)
 ![Tmux](https://img.shields.io/badge/tmux-1BB91F?style=for-the-badge&logo=tmux&logoColor=white)
-![Nushell](https://img.shields.io/badge/Nushell-4E9A06?style=for-the-badge&logo=gnu-bash&logoColor=white)
 ![Zsh](https://img.shields.io/badge/Zsh-F15A24?style=for-the-badge&logo=gnu-bash&logoColor=white)
 
 ## ✨ Features
 
 ### 🤖 AI-Enhanced Development
 - **CodeCompanion** - AI chat and inline assistance
-- **GitHub Copilot** - Primary AI code completion with ergonomic keybindings
+- **GitHub Copilot** - Code completion with ergonomic keybindings
 - **Database AI** - AI-powered SQL assistance
 - **Unified AI System** - Streamlined AI completion with conflict prevention
 
 ### 🪟 Window Management
 - **Yabai** - Tiling window manager with BSP layout
 - **SKHD** - Hotkey daemon for seamless app switching
-- **Sketchybar** - Custom status bar with system info
+- **Karabiner** - Advanced keyboard customization
 
 ### 💻 Terminal & Shell
-- **Nushell** - Modern shell with structured data processing (primary)
-- **Zsh** with Oh My Zsh and Powerlevel10k (maintained)
+- **Zsh** with Oh My Zsh and Powerlevel10k
 - **Tmux** with custom keybindings and session management
-- **Ghostty** - Modern terminal emulator with Nushell integration
-- **Starship** - Cross-shell prompt with P10K-inspired lean theme
+- **Ghostty** - Modern terminal emulator (primary)
+- **Starship** - Cross-shell prompt with modern styling
 
 ### 🛠️ Development Tools
 - **Neovim** - AstroNvim v5 with LSP, treesitter, and AI
@@ -89,10 +87,8 @@ dotfiles/
 ├── kitty/         # Kitty terminal config
 ├── lazygit/       # Git TUI configuration
 ├── mise/          # Runtime version manager
-├── nushell/       # Nushell configuration with Starship theme
 ├── nvim/          # Neovim configuration (AstroNvim)
 ├── nvim-vscode/   # VSCode Neovim integration
-├── sketchybar/    # Status bar configuration
 ├── skhd/          # Hotkey daemon config
 ├── starship/      # Shell prompt config
 ├── task/          # Task runner config
@@ -145,19 +141,14 @@ dotfiles/
 | `<C-f>` | Project Sessionizer |
 | `-` | File Manager (Oil) |
 
-### Nushell (Primary Shell)
+### Zsh Utilities
 | Command | Action |
 |---------|--------|
 | `yy [args]` | Yazi file manager with directory change |
 | `nvim-select` or `nv` | Select file to edit with Neovim |
-| `nvim-config [type]` or `nc` | Quick edit config files |
-| `edit-config` | Edit Nushell configuration |
-| `edit-env` | Edit Nushell environment |
-| `starship-lean` or `st-lean` | Switch to lean P10K-style theme |
-| `starship-full` or `st-full` | Switch to full Starship theme |
-| `starship-info` or `st-info` | Show current theme info |
-| `ghcs <cmd>` | GitHub Copilot suggest command |
-| `ghce <cmd>` | GitHub Copilot explain command |
+| `p10k configure` | Configure Powerlevel10k theme |
+| `tmux-sessionizer` | Quick project switcher in Tmux |
+| `source ~/.zshrc` | Reload shell configuration |
 
 ### AI Completion (GitHub Copilot)
 | Shortcut | Action |
@@ -174,17 +165,17 @@ dotfiles/
 
 ### Neovim Features
 - **AstroNvim v5** - Modern Neovim distribution
-- **AI Integration** - Multiple AI assistants for coding
-- **Database Tools** - Advanced SQL development with MFA support
+- **AI Integration** - Multiple AI assistants (Copilot, CodeCompanion)
+- **Database Tools** - Advanced SQL development with Snowflake support
 - **LSP Support** - Language servers for multiple languages
 - **Custom Dashboard** - Branded startup screen
 
-### Nushell Shell
-- **Structured Data** - Built-in JSON, CSV, SQL processing
-- **Modern Features** - Fuzzy completion, vi-mode editing
-- **Starship Integration** - P10K-inspired lean theme with Catppuccin colors
+### Zsh Shell
+- **Oh My Zsh** - Framework with plugins and themes
+- **Powerlevel10k** - Feature-rich prompt with instant feedback
+- **Starship Theme** - Modern alternative prompt configuration
 - **Tool Integration** - Atuin history, Zoxide navigation, Direnv support
-- **Theme Switching** - Easy toggle between lean and full prompt themes
+- **Shell Aliases** - Atuin-managed aliases with import/export
 
 ### Tmux Workflow
 - **Project Sessionizer** - Quick project switching with FZF
@@ -195,8 +186,8 @@ dotfiles/
 ### Window Management
 - **BSP Layout** - Binary space partitioning for optimal screen usage
 - **Smart Gaps** - 5px gaps with toggle functionality
-- **App Rules** - Specific behavior for different applications
-- **Mouse Integration** - Fn + mouse for window manipulation
+- **App Rules** - Specific window behavior per application
+- **Hotkey System** - Modal shortcuts with SKHD
 
 ## 🛠️ Customization
 
@@ -211,8 +202,8 @@ dotfiles/
 - **Tmux bindings**: Edit `dotfiles/tmux/.tmux.conf`
 
 ### Shell & Terminal Configuration
-- **Nushell Setup**: See `docs/NUSHELL_SETUP.md` - Modern shell configuration
-- **Zsh Fallback**: Original zsh config maintained for compatibility
+- **Zsh Setup**: Primary shell with Oh My Zsh and Powerlevel10k
+- **Ghostty**: Modern terminal emulator with optimized settings
 
 ### AI Configuration
 See documentation in `dotfiles/nvim/.config/nvim/docs/`:
@@ -229,23 +220,22 @@ make stow-install    # Install all dotfiles
 make stow-clean      # Remove all symlinks
 
 # System maintenance
-./scripts/macos-deps.sh      # Install dependencies
-./scripts/yabai-upgrade.sh   # Upgrade window manager
+./scripts/macos-deps.sh      # Install macOS dependencies
+./scripts/yabai-upgrade.sh   # Upgrade Yabai window manager
 
 # Alias management (Atuin)
 make export-aliases  # Export current aliases to file
 make import-aliases  # Import aliases from file
 make backup-aliases  # Export and commit aliases to git
 
 # Tmux utilities
-~/.local/bin/tmux-sessionizer    # Project switcher
-~/.local/bin/tmux-windowizer     # Window manager
+~/.local/bin/tmux-sessionizer    # Quick project switcher
+~/.local/bin/tmux-windowizer     # Window/pane management
 
-# Nushell utilities
-starship-lean                    # Switch to lean P10K-style theme
-starship-full                    # Switch to full Starship theme
+# Utilities
 nvim-select                      # Interactive file selection for editing
 yy                               # Yazi file manager with directory change
+p10k configure                   # Configure Powerlevel10k prompt
 ```
 
 ## 🔍 Troubleshooting
@@ -276,15 +266,7 @@ git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm
 - Verify network connectivity
 - See individual setup guides in `docs/` folder
 
-## 🤝 Contributing
-
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Test thoroughly
-5. Submit a pull request
-
-## 📚 References & Inspiration
+## 📚 References
 
 - [GNU Stow Guide](https://dr563105.github.io/blog/manage-dotfiles-with-gnu-stow/)
 - [AstroNvim Documentation](https://docs.astronvim.com/)

docs/codebase-summary.md

@@ -0,0 +1,145 @@
+# Codebase Summary
+
+Duc's Digital Workspace: AI-enhanced macOS development environment with 22 dotfiles packages managed via GNU Stow.
+
+## Structure Overview
+
+### Core Packages (22 total)
+
+**Editors & IDEs:**
+- `nvim` - Neovim with AstroNvim v5 distribution
+- `nvim-vscode` - VSCode Neovim integration
+- `vscode` - VSCode settings and keybindings
+
+**Terminal & Shell:**
+- `zsh` - Primary shell configuration with Oh My Zsh
+- `tmux` - Terminal multiplexer with custom plugins
+- `ghostty` - Modern terminal emulator
+- `kitty` - Alternative terminal emulator
+- `atuin` - Intelligent shell history with sync
+- `starship` - Cross-shell prompt configuration
+
+**Window Management:**
+- `yabai` - Tiling window manager (BSP layout)
+- `skhd` - Hotkey daemon for app switching
+- `karabiner` - Keyboard customization
+- `hammerspoon` - macOS automation scripts
+
+**File & Git Management:**
+- `yazi` - File manager with custom plugins
+- `lazygit` - Git TUI configuration
+- `bin` - Custom scripts (tmux-sessionizer, git-worktree-manager, etc.)
+
+**Development Tools:**
+- `direnv` - Automatic environment loading
+- `mise` - Runtime version management
+- `task` - Task runner configuration
+- `zathura` - PDF viewer configuration
+
+**Other:**
+- `claude` - Claude AI user configuration
+- `vrapperrc` - Vim keybindings for Eclipse
+
+### Scripts (13 scripts)
+
+**Installation & Setup:**
+- `scripts/macos-deps.sh` - Install macOS dependencies
+- `scripts/ci/` - CI pipeline scripts (validate, check-dependencies, test-platforms)
+
+**Neovim Management:**
+- `scripts/nvim-install-parser.sh` - Install treesitter parsers
+- `scripts/nvim-treesitter-arm64.sh` - ARM64 specific setup
+- `scripts/refresh-nvim.sh` - Refresh Neovim plugins
+
+**Maintenance:**
+- `scripts/yabai-upgrade.sh` - Update window manager
+- `scripts/export-atuin-aliases.sh` - Export shell aliases
+- `scripts/import-atuin-aliases.sh` - Import shell aliases
+- `scripts/appscript-notifications.scpt` - macOS notifications
+
+### Configuration Files
+
+- `Makefile` - Build automation (stow install/clean, alias management)
+- `.stow-local-ignore` - GNU Stow ignore patterns
+- `.repomixignore` - Repomix packing exclusions
+- `.gitleaksignore` - Secrets scanning exclusions
+- `.gitignore` - Git ignore patterns
+- `zensical.toml` - Documentation site configuration
+- `mise.toml` - Runtime version specifications
+- `CLAUDE.md` - Claude AI project instructions
+
+### Documentation
+
+- `docs/` - Main documentation folder with guides for all tools
+- `dotfiles/nvim/.config/nvim/docs/` - Neovim-specific AI documentation
+
+## Key Features
+
+### Window Management
+- **Yabai** - Binary space partitioning with 5px gaps
+- **SKHD** - Modal hotkey system with app shortcuts
+- **App Rules** - Specific window behavior per application
+
+### AI Integration
+- **GitHub Copilot** - Code completion with custom keybindings
+- **CodeCompanion** - OpenAI chat and inline assistance
+- **Database AI** - SQL-specific AI helpers
+- **Unified System** - Conflict prevention across AI tools
+
+### Terminal Workflows
+- **Tmux** - Session management with custom plugins
+- **Atuin** - Command history with cloud sync
+- **Starship** - Modern shell prompt with themes
+- **Ghostty** - Primary terminal with modern features
+
+### Development Environment
+- **AstroNvim** - Modern Neovim distribution
+- **Language Servers** - LSP support for multiple languages
+- **Database Tools** - Advanced SQL with Snowflake support
+- **Version Management** - Mise for runtime versions
+
+## Dependencies
+
+**System:**
+- macOS 12.0+
+- Homebrew
+- Git
+- GNU Stow
+
+**Installed via Scripts:**
+- Neovim + plugins
+- Tmux + TPM
+- Terminal emulators (Ghostty, Kitty)
+- Development tools (Node, Python, Rust)
+- Window managers (Yabai, SKHD)
+
+## File Statistics
+
+- Total Files: 102
+- Total Tokens: 126,785
+- Configuration-heavy (minimal code)
+- Well-documented with inline comments
+
+## Maintenance
+
+**Key Files for Updates:**
+- `Makefile` - Installation procedures
+- `README.md` - Public documentation
+- `CLAUDE.md` - Development instructions
+- `dotfiles/nvim/` - Editor configuration
+- `dotfiles/zsh/.zshrc` - Shell setup
+
+**Common Tasks:**
+- Stow install/clean: `make stow-install/clean`
+- Alias management: `make export/import-aliases`
+- Service restart: `brew services restart yabai skhd`
+- Plugin updates: `:Lazy sync` (Neovim), `prefix + I` (Tmux)
+
+## Documentation Hierarchy
+
+1. **Installation** - Setup from scratch
+2. **Quick Reference** - Essential commands
+3. **Tool Guides** - Detailed configuration (Tmux, SKHD, Atuin, etc.)
+4. **Troubleshooting** - Common issues and fixes
+5. **AI Workflows** - Best practices for AI tools
+6. **Advanced** - Custom configurations and extensions

docs/index.md

@@ -1,42 +1,42 @@
 ---
 title: Home
-description: Comprehensive AI-enhanced development environment for macOS
+description: AI-enhanced macOS development environment documentation
 ---
 
 # Duc's Digital Workspace
 
-Welcome to the comprehensive documentation for this modern macOS development environment. This wiki contains detailed guides, troubleshooting tips, and configuration options for all components.
+Welcome to the comprehensive documentation for this modern macOS development environment. Quick setup, configuration guides, and troubleshooting for all tools.
 
 ## Getting Started
 
-- [Installation Guide](installation.md) - Complete setup instructions
+- [Installation Guide](installation.md) - Complete setup from scratch
 - [Quick Reference](quick-reference.md) - Essential commands and shortcuts
+- [Troubleshooting](troubleshooting.md) - Common issues and solutions
 
-## Core Tools
+## Core Tools Documentation
 
-- [Neovim](neovim/README.md) - Editor configuration and plugins
-- [Zen Mode](zen-mode.md) - Distraction-free coding environment
-- [Tmux](tmux.md) - Terminal multiplexer setup and workflows
-- [Atuin](atuin.md) - Intelligent shell history and sync
-- [SKHD](skhd.md) - Hotkey daemon configuration
+**Terminal & Multiplexing:**
+- [Tmux Setup](tmux.md) - Terminal multiplexer configuration
+- [Atuin](atuin.md) - Shell history and sync
 
-## AI Tools
+**Window Management:**
+- [SKHD Configuration](skhd.md) - Hotkey daemon setup
 
-- [AI Workflows](ai/workflows.md) - Best practices and tips for AI-assisted development
+**Editors & IDE:**
+- [Neovim Configuration](neovim/README.md) - AstroNvim v5 setup
 
-## Workflows
-
-- [Development Workflows](workflows/development.md) - Daily development patterns
-- [Temporal](temporal.md) - Workflow orchestration
+**Development Workflows:**
+- [Zen Mode](zen-mode.md) - Distraction-free coding with Tmux
+- [AI Workflows](ai/workflows.md) - Best practices for AI-assisted coding
 
 ## Quick Help
 
 ### Common Commands
 
 ```bash
-# Restart window manager
-skhd --restart-service
-yabai --restart-service
+# Restart services
+brew services restart yabai
+brew services restart skhd
 
 # Reload configurations
 tmux source-file ~/.tmux.conf
@@ -53,14 +53,21 @@ prefix + I  # In Tmux
 # If window manager breaks
 killall yabai skhd
 brew services restart yabai
-brew services restart skhd
 
-# If terminal is broken
+# If terminal breaks
 /Applications/Ghostty.app/Contents/MacOS/ghostty
 ```
 
-### Getting Help
+## 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
 
-- Check the [Troubleshooting Guide](troubleshooting.md)
-- Review configuration files in `dotfiles/`
-- Check the main README for basic setup
+- [Codebase Summary](../docs/codebase-summary.md) - Project structure overview
+- [Main README](../README.md) - Feature highlights and badges
+- [Neovim Docs](../dotfiles/nvim/.config/nvim/docs/) - AI tools and plugins