dotfiles

Personal dotfiles and macOS workstation provisioning.

Quick start

# Lightweight bootstrap: symlinks, shell config, utilities
./bootstrap.sh

# Full macOS provisioning (Homebrew, defaults, apps, shortcuts)
./macos_setup.sh [work|personal|server]

Repo-local GitHub SSH override

This repo's remote is git@github.com:soldni/dotfiles.git, but on this machine the global ~/.ssh/config can inject the wrong identity via a broad Host * stanza. Setting only -i ~/.ssh/personal is not enough, because SSH still reads the global config and may offer another key first.

If git push starts authenticating as the wrong GitHub account, set a repo-local SSH command that ignores global SSH config entirely:

git config core.sshCommand 'ssh -F /dev/null -i ~/.ssh/personal -o IdentitiesOnly=yes'

Why this works:

• -F /dev/null tells ssh not to read ~/.ssh/config.
• -i ~/.ssh/personal pins the key for this repo.
• -o IdentitiesOnly=yes prevents ssh from offering extra identities from the agent or config.

Verify it with:

GIT_TRACE=1 git push --dry-run origin HEAD

You should see Git invoke ssh -F /dev/null -i ~/.ssh/personal -o IdentitiesOnly=yes ... and the dry run should succeed.

What's here

• Shell config -- .bashrc (shared by bash/zsh), .tmux.conf, .vimrc
• Editor/terminal settings -- Ghostty, Zed, VS Code, Cursor, Sublime Text, iTerm2
• macOS app preferences -- backed up and restored via plist_manager.sh using defaults export/import (quits and relaunches apps automatically)
• macOS defaults and shortcuts -- macos_setup.sh, macos_shortcuts.sh
• Utility scripts -- home-symlink/.local/scripts/

App preference sync

# Back up all tracked app preferences
./plist_manager.sh backup

# Restore all tracked app preferences
./plist_manager.sh restore

The script derives the app name from the preference domain, quits it before export/import, and relaunches afterward. Sensitive keys (license, email, etc.) are stripped automatically during backup.

IDE backup and restore

# Back up VS Code and Cursor extensions, settings, and keyboard shortcuts
./ide_extensions.sh backup

# Limit backup or restore to one editor (code or cursor)
./ide_extensions.sh backup code
./ide_extensions.sh restore code

Backups use extensions.txt, settings.json, and keybindings.json under home-symlink/Library/Application Support/{Code,Cursor}/User/. The script copies settings and shortcuts from the default user directories on macOS or Linux (respecting XDG_CONFIG_HOME on Linux), even if the editor CLI is missing. Missing files are skipped, preserving existing backups.

home-symlink.sh already links these config files into the repo, so linked files need no copying. Explicit backup also captures files that have become regular files. Restore copies settings and shortcuts back and replaces installed extensions with the saved list.

See AGENTS.md for full details.