My dotfiles

English · 简体中文

Personal dotfiles for Apple Silicon macOS. Intel Macs are not supported.

A Zsh, Kitty, tmux, and Neovim environment with AeroSpace window management, SketchyBar, Yazi, and VS Code settings. Files in home/ are deployed with GNU Stow; Brewfile and setup.sh manage dependencies.

Quick start

xcode-select --install   # once, if the Command Line Tools are missing
git clone git@github.com:BiboyQG/dotfiles.git
cd dotfiles
zsh setup.sh --skip-system-defaults

Setup installs or updates tools, links configurations, and restarts or reloads OpenUsage, LockIME, AeroSpace, and SketchyBar. To also apply macOS defaults and NVRAM preferences, run zsh setup.sh.

Checks

zsh check.sh          # Deterministic checks and isolated deployment simulations
zsh check.sh --live   # Also inspect installed tools and the current machine

Documentation

• Setup and maintenance: installation details, configuration layout, agent instructions, local overrides, and troubleshooting.
• Everyday usage: tmux session slots, keyboard shortcuts, and shell helpers.
• Tools: package inventory and installation methods.