dotfiles

The dotfiles for macOS.

♥ the Vim.

Commands

The main tasks are Makefile targets. To see the available commands provided by the install, uninstall, update and help scripts run:

make help

New Machine

1. Setup iCloud
2. Install App store applications
3. Install Ghostty
4. Run xcode-select --install
5. Install homebrew
6. Run /opt/homebrew/bin/brew install git
7. Run git clone https://github.com/mkitt/dotfiles.git && cd dotfiles
8. Add the gitconfig.local file to the dotfiles directory
9. Run make install for dotfiles
10. Install Claude Code
11. Follow post install instructions (Vim plugins)
12. Map caps lock to the control key
13. Set other reasonable macOS defaults
14. Restart to pick up reasonable defaults
15. Create new SSH & update GPG keys
16. Run gh auth login
17. Switch the dotfiles repo from https to ssh
18. Pull down key repositories
19. Setup all Application settings
20. Wipe old computer

MDM Detection

The Brewfile automatically detects whether you're on a work or personal machine by checking for Jamf MDM receipts in /var/db/receipts/. This controls which apps get installed:

• Work machine (Jamf detected): Skips personal apps like Dropbox, Backblaze, and Signal. Also skips cask installs for apps already managed by MDM (1Password, Slack, Zoom).
• Personal machine (no MDM): Installs everything.

The make install target prints which mode was detected before running.

Tips

Git Credentials

To setup your git credentials you'll need to add a gitconfig.local file to your the root directory and add the following:

[user]
  name = YOUR_GIT_AUTHOR_NAME
  email = YOUR_GIT_AUTHOR_EMAIL
  # signingKey = YOUR_GIT_GPG_SIGNING_KEY
[github]
  user = YOUR_GITHUB_USERNAME

• The installscript symlinks this file to $HOME/.gitconfig.local
• The global .gitignore is set to omit any *.local files

GPG

Install GPG Keychain for GPG signing to happen automatically. See GPG Tools for more information. To get your GPG signing key you can either open up GPG Keychain, or run gpg --list-keys and add this to in your .gitconfig.local file. If you are transferring a key to a new computer see the knowledge base article

---

mkitt.net | github/mkitt