to update run:

make
# or restow one package:
stow -d ~/dotfiles -t "${HOME}" --no-folding -v -R emacs

On macOS, install the default packages plus optional iTerm profiles:

make macos

Git

On macOS machines using Homebrew, run this from the dotfiles repo root to link the local Git config to the Homebrew specific config:

ln -sf "$(pwd)/git/.config/git/config_macos_homebrew" ~/.config/git/config_local

Per-machine SSH key setup

Generate an ed25519 key and upload it to GitHub for both authentication and commit signing:

ssh-keygen -t ed25519 -C "shilling.jake@gmail.com" -f ~/.ssh/id_ed25519

Add the public key to GitHub at https://github.com/settings/keys. Add it as both an Authentication Key and a Signing Key (same key can be used for both).

iTerm2

Install the optional iTerm package on macOS:

make iterm

This adds an iTerm2 dynamic profile named Default + Command Meta that inherits from the local Default profile. Select that profile in iTerm to make these terminal-session bindings work:

• Cmd-f sends M-f / forward word
• Cmd-b sends M-b / backward word
• Cmd-d sends M-d / kill word
• Cmd-Delete sends M-DEL / backward kill word

To verify the raw terminal input, run cat -v in an iTerm session using the profile. Pressing Cmd-f should print ^[f.

Emacs

CFLAGS='-march=native -O3' \
CC=gcc-14 \
../configure --with-native-compilation=aot \
      --with-tree-sitter \
      --with-gif \
      --with-png \
      --with-jpeg \
      --with-rsvg \
      --with-tiff \
      --with-imagemagick \
      --with-pgtk \
      --with-mailutils \
      --with-modules --prefix="${HOME}/.local"

deps

• build-essentials
• autoconf
• texinfo
• libmagickwand-dev libmagick++-dev imagemagick
• libgccjit0 libgccjit-14-dev
• libwebkit2gtk-4.1-dev

PyEnv

curl -fsSL https://pyenv.run | bash

apt install \
    build-essential libssl-dev zlib1g-dev \
    libbz2-dev libreadline-dev libsqlite3-dev curl git \
    libncurses-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev \
    libffi-dev liblzma-dev

NVM

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash

PHP

/bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.4)"

curl -Lo phpactor.phar https://github.com/phpactor/phpactor/releases/latest/download/phpactor.phar
chmod a+x phpactor.phar
mv phpactor.phar ~/.local/bin/phpactor

Haskell

GHCup

curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh

Common Lisp

Roswell: https://github.com/roswell/roswell/wiki/Installation#linux