Dotfiles

Personal dotfiles for Mac and Linux development environments. Manages vim, tmux, zsh, git, and various development tool configurations.

Quick Start

Mac

# Prerequisites
# - Latest Mac OS
# - Clone private `environment_configurations` repo in same parent directory

# Run main setup script
mac/make.sh

Linux

# Run main setup script
linux/make.sh

Directory Structure

• mac/ - Mac-specific configurations and scripts
• linux/ - Linux-specific configurations and scripts
• shared/ - Cross-platform configurations (vim, zsh, tmux, git)

Setup Details

Mac

• Make sure you're on the latest Mac OS
• Clone the private environment_configurations repo in the same parent directory as this dotfiles repo
• Run mac/make.sh which executes:
  1. mac/scripts/dependencies.sh - Install Homebrew packages
  2. mac/scripts/symlink_to_dotfiles_repo.sh - Create symlinks to dotfiles
  3. Linux settings scripts (for cross-platform settings)
• This repo assumes the home dir is jklein. If it's not, symlink it with:

  cd /Users
  sudo ln -s james jklein

• Show hidden files in Finder with defaults write com.apple.Finder AppleShowAllFiles true && killall Finder

Installing Fonts

• Open the font file and install it to the Mac Font Book
  • open mac/config/Fura\ Mono\ Regular\ Nerd\ Font\ Complete\ Mono\ Windows\ Compatible.otf
• In iTerm, set the font to that font for the current profile. Profiles > Text > Font
• Restart vim and you should see devicons

Syncing Settings

• To save local settings to the repo: linux/scripts/backup_settings.sh
• To apply repo settings to the local machine: linux/scripts/restore_settings.sh (part of make script)

Sequel Pro

• Dark query scheme found in mac/config/sequel-pro/

Additional environment configurations

• Chrome theme - Dark Theme v3
• See $PRIVATE_CONFIGS_DIR/README.txt

Userscripts

Stored in bookmarks on my google chrome account.

NVM

I set the system ~/.nvmrc -> dotfiles/nvmrc and have that fetching node which is the latest node version. Any project without a .nvmrc will use the latest since it will traverse up the dirs to find my root one

TMUX & Tmuxinator

Default tmux config taken from oh-my-tmux

Tmuxinator project configurations are stored in shared/tmux/.tmuxinator/ and symlinked to ~/.tmuxinator/.

Usage

# Create new tmuxinator config
mac/scripts/new_tmuxinator_config.rb [project_name]

# Start a tmux session
tmuxinator start [project_name]
# or shorthand:
mux [project_name]

# Debug tmuxinator config
tmuxinator debug [project_name]

Alfred

• Settings are stored in the private env config path in Google Drive.
• This should already be stored in settings but if not, use this script to get Alfred <> iTerm2 integration

VIM

• Main config located in shared/.vimrc
• Uses vim-plug for plugin management
• Followed this guide to set up ctags using git hooks
• Uses vim-projectionist to define alternate files as explained here. Each project has a .projections.json defined and globally git ignored.
• Install pythonx dependencies with the following. Note that vim-pyenv takes care of using the pyenv, not system version of python:

pip install -r shared/vim/.vim/pythonx/requirements.txt

iTunes

• For Alfred iTunes miniplayer: In iTunes go to Preferences > Advanced > Share iTunes Library XML with other applications

SSH

To set up ssh and rsync without asking for a password. See this guide NOTE: the same id_rsa.pub is shared so this should not be necessary

ssh-copy-id -i ~/.ssh/id_rsa.pub [email protected]

• See $LOCAL_CONFIG (vim leader + lcl) for additional configurations

Neovim

I'm not using neovim currently but to get it set up I used the following

brew install neovim
created ~/.config/nvm/init.vim

# run :checkhealth

# https://github.com/zchee/deoplete-jedi/wiki/Setting-up-Python-for-Neovim
sudo pip2 install --user neovim
sudo pip3 install --user neovim

gem install neovim

Quiver

• Quiver settings are stored in mac/config/Quiver-settings.json

Security

Sensitive files are automatically excluded via .gitignore:

• mac/.claude/.credentials.json and related credential files
• *.key, *.pem, *.cert
• .env and .env.* files
• Private configurations should be stored in the separate environment_configurations repository

Troubleshooting

• If you're getting a message about __init_nvm not being defined, nvm likely added something to the .zshrc. Check the bottom of the file.

Linux

Setup

Run linux/make.sh which executes:

1. linux/scripts/dependencies.sh - Install system packages
2. linux/scripts/restore_settings.sh - Apply Linux settings
3. linux/scripts/symlink_to_dotfiles_repo.sh - Create symlinks
4. linux/scripts/fontconfig.sh - Configure fonts

Apt-get

• Packages and sources are backed up as part of the dependency scripts

Apple Magic Mouse

• The apt_get.sh dependency script installs a tool called Ukuu that can be used to manage the kernel version
• Type uname -a to find out your version. It needs to be >= 4.18.0. See https://github.com/rohitpid/Linux-Magic-Trackpad-2-Driver#installation-with-dkms
• Start Ukuu and select kernel 4.20.0 (tested with this one and it works)
• Restart
• Run linux/scripts/setup_magic_mouse.sh

Albert

• Albert and CopyQ will get installed as part of dependencies. The linux restore settings script will provide the custom keyboard shortcut to open the paste buffer.
• The only thing you need to do is make sure the python scripts, specifically copyq, is enabled in alfred preferences. Settings -> Extensions -> Python -> CopyQ