All my config files for macOS.

• arken: Firefox Hardening via arkenfox/user.js
• chrome: Currently unused, but Firefox UI tweaking
• config/.config: anything that expects to land in ~/.config
  • aerospace: config for aerospace window manager
  • commit-helper: config options for generate-commit script (Claude-powered conventional commit generator)
  • karabiner: configs for Karabiner Elements with sublayering via mxstbr
  • sketchybar: i3-inspired bottom bar for macOS via sketchybar
  • skhd: keybinds for controlling yabai windows via skhd - OUTDATED, not in use
  • yabai: tiling window manager via yabai - OUTDATED, not in use
• defaults: macOS specific settings (noTunes config, wifi toggle script, etc.)
• git: Default git message, global git ignore, etc.
• gitmux: tmux statusline git status config
• tmux: tmux configuration
• wezterm: wezterm terminal emulator settings
• xcode: Xcode keybinds, theme, and cheatsheet
• zsh: Shell aliases, theming, utils, etc.
• tests: Unit tests for dotfiles using bats-core testing framework (see tests/README.md for setup and usage)

• nvim-old: awful, old, vimscript-based dev setup using Plug package manager. Don't look, don't use.
• init.el: Emacs stuff, not great, somewhat out of date probably.
• nvim1: slightly better, Lua-only dev setup using Packer package manager. Don't look, don't use.

1. Clone this repo into home directory
2. Install homebrew via /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3. brew bundle install --file ./brew/Brewfile
4. Run ./install to move config files to HOME_DIR.
5. Open nvim and plugins will start installing
6. Close nvim once the plugins are installed
7. Reopen nvim and let LSPs install
8. Install the few apps listed in Current Favorite Tools that are labeled "not included in brew install script"
9. Run ln -s ~/.dotfiles/susman.zsh-theme ~/.oh-my-zsh/themes to grab my custom OhMyZSH theme
10. Run ln -s ~/.dotfiles/git/.gitignore ~/.gitignore && git config --global core.excludesfile ~/.gitignore to setup worktrees flow
11. Run ln -s ~/.dotfiles/config/.config/claude/settings.json ~/.claude/settings.json to setup user settings for Claude Code

1. Ensure sourcekit-lsp and xcodebuild.nvim are installed in your nvim setup. Ensure xcode-build-server is on your machine (should've been installed in brew install script).
2. Navigate to the root directory of your XCode project/workspace.
3. Run xcode-build-server config -scheme <XXX> -workspace *.xcworkspace, where <XXX> is the target you plan to build/run. You can be more specific than *.xcworkspace if you'd like.
4. Reopen nvim and LSP/BSP should be working, <leader>xr should build and run your project

Here's a running list of things I enjoy using right now. A lot of them are macOS specific, but some are platform agnostic.

• ghostty: fast terminal emulator, written by Mitchell Hashimoto
• lazygit: incredibly powerful git TUI
• aerospace: i3-like tiling window manager for macOS
• sesh: tmux session manager
• Leader Key: app/url launcher with prefix key and breadcrumbs
• gh-dash: GitHub dashboard TUI
• Karabiner Elements: Remap Fn to Hyper, Ctrl+P/Ctrl+n to Arrow Up/Down, mnemonic sublayering for media control, movement, opening browser links, opening applications, etc.
• Maccy: Clipboard manager
• Gifski: Video to Gif converter
• noTunes: Prevent Apple Music from launching
• zoxide: Smarter cd
• ripgrep: More powerful grep
• Firefox Dev Edition: Hopefully self explanatory at this point, source code here
• TinkerTool: Sane macOS defaults, set them once and never open the app again. (NOT INCLUDED IN BREW INSTALL SCRIPT)

• Cleanshot X: Better screenshotting
• Choosy Browser: Send certain links to certain browsers
• 1Password: Password manager