A keyboard-first macOS distro. Remove friction between thought and execution.
A modular guide for operating your machine with minimal interface friction. Vimish navigation everywhere. Universal keybinds across applications. No mouse required.
- Check prerequisites
- Install Homebrew
- Run the bootstrap script
- Clone dotfiles and stow packages
- Introduction — motivation and goals
- Philosophy — core principles
- Prerequisites — what you need before starting
- Setup — tool list with links
- Dotfiles — configuration management with GNU Stow
- Desktops — workspace layout with Aerospace
- Keybinds — per-application shortcuts
- Plugins — plugin configurations
- Settings — system settings
- Scripts — automation scripts
- Agents — AI agent workflows
- VM Setup — virtualization guides (UTM, QEMU, FreeBSD)
GUIs: Aerospace, Ghostty, Obsidian, Raycast, Shortcat, Karabiner Elements, Vimium
TUIs: nvim, tmux, ranger, lsd, gnu-stow, btop, opencode
Keyboard-only means removing friction wherever possible. Minimal hand movement. Predictable, composable shortcuts. Easy to learn incrementally.
MIT