Skip to content

README.md

Latest commit

 

History

History
90 lines (67 loc) · 2.75 KB

README.md

File metadata and controls

90 lines (67 loc) · 2.75 KB
Raw

dotfiles

source order:

config.fish >
  local.sh, 
  $platform.fish > common.fish,
  local.fish

.zshrc >
  local.sh,
  zsh_$platform > zsh_common,
  zsh_local

user should modify:

  • ~/.config/local.sh # variables
  • ~/.config/fish/local.fish # fish overrides
  • ~/.config/zsh/zsh_local # zsh overrides

contributing

  • if new files are added to dotfiles/src, then run restow to update symlinks

macbook setup

prerequisites (manual)

  1. install 1Password and sign in
  2. 1Password Settings → Developer:
    • enable Use the SSH Agent
    • enable Integrate with 1Password CLI
    • enable Generate SSH config file with bookmarked hosts

bootstrap (one command)

Run from the native macOS Terminal (not alacritty):

curl -fsSL https://raw.githubusercontent.com/tim-codes/dotfiles/main/scripts/bootstrap | zsh

This installs Xcode Command Line Tools, wires ~/.ssh/config to the 1Password SSH agent, clones this repo to ~/dev/dotfiles (SSH, with submodules), then runs scripts/init: local config files, homebrew + deps, stow symlinks, fish plugins, fonts, alacritty (cask), tmux plugins (tpm), nvm/node, rust, poetry. Safe to re-run at any point if a step fails.

post-bootstrap (manual)

  1. set the git signingkey in ~/.gpg.gitconfig — commit signing uses the 1Password SSH key (see the "Git" item in 1Password):
[user]
    signingkey = xxx
  1. where there are multiple ssh keys for the same domain, see (a) below
  2. remaining app installs: Arc Browser, SetApp, JetBrains Toolbox + VSCode

(a) where there is multiple e.g. github ssh keys for the same domain, then download the public keys to ~/.ssh/, and add entries for unique remote names to ~/.ssh/config:

Host github.com
  hostname github.com
  identityfile ~/.ssh/github.pub
  identitiesonly yes

Host skygit
  hostname github.com
  identityfile ~/.ssh/github_sky.pub
  identitiesonly yes

Host *
    IdentityAgent "~/Library/Group Containers/2BUA8C4S2C.com.1password/t/agent.sock"

--> then use e.g. gcl git@skygit:<workspace>/<repo>.git for the origin remote

references

notes

  • when running the init script, it is most reliable to open zsh in native terminal (not alacritty or another emulator), then run eg ./dev/dotfiles/scripts/init
  • storing GPG keys in 1password as a reference, but they are not integrated, the local GPG key is used for signing
  • maybe this tool will help with the bash->fish PATH loading: https://github.com/edc/bass
  • todo: the fisher install step is not idempotent and is super flaky between different shells