Skip to content
croakyPublic

About

Setup script and dotfiles

Resources

Stars

35 stars

Watchers

2 watching

Forks

Latest commit

 

History

1,341 Commits

Folders and files

Repository files navigation

Laptop

Set up a macOS machine as a software development environment.

Install

Clone onto laptop:

export LAPTOP="$HOME/laptop"
git clone https://github.com/croaky/laptop.git $LAPTOP
cd $LAPTOP

Review:

less laptop.sh

Run:

./laptop.sh

The script can safely be run multiple times. It is tested on the latest version of macOS on an arm64 (Apple Silicon) chip.

The script links the dotfiles to the main clone, ~/laptop, also when it runs from a change worktree. So a test run from a worktree is safe after mergetree deletes it. A change to a dotfile, such as shell/bashrc, takes effect after the merge and a git pull in ~/laptop.

Run the tests with test/run.sh. They need the tools that laptop.sh installs.

laptop.sh also sets some macOS settings. The comments in laptop.sh say why, and how to keep a different value.

The script does not do the sections that follow. They are one-time setup items.

SSH key

Ed25519 uses elliptic curve cryptography with good security and performance.

Create the key:

ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 -C "$(whoami)@$(hostname)"

Start the SSH agent:

eval "$(ssh-agent -s)"

Add the private key to the SSH agent on macOS:

ssh-add --apple-use-keychain ~/.ssh/id_ed25519

Copy the public key to macOS clipboard:

cat ~/.ssh/id_ed25519.pub | pbcopy

Upload the public key to GitHub.

Git

Set your Git and GitHub user in ~/.gitconfig.local to keep it out of version control:

[github]
  user = yourgithubusername
[user]
  name = Your Name
  email = you@example.com

Change worktrees

createtree, mergetree, and closetree use soc when origin matches a configured sockeye server. For other repos, they use git create-tree. co <change-id> changes directory to the worktree of a change.

Install soc with go install ./cmd/soc from a clone of sockeye. Run soc help for the commands. The sockeye source has the details.

Name each server in ~/.gitconfig.local:

[sockeye]
  url = https://personal.example.com
[sockeye "personal"]
  url = https://personal.example.com
[sockeye "work"]
  url = https://work.example.com

Then run soc git setup and soc login. ~/.gitconfig is a symlink to git/gitconfig, which this repo tracks. Move what soc writes there, such as a credential block, to ~/.gitconfig.local. git/gitconfig includes that file.

Trusted repos

A cloned repo, or a change that somebody else pushed, can hold programs. The shell and Neovim do not run them by themselves:

  • PATH has only absolute directories, so the shell never looks in ./bin. Run a project script by its path, such as ./bin/gotest.
  • Format-on-save runs dprint from ~/.local/bin and goimports from ~/go/bin, the versions that laptop.sh pins.

A trusted repo also gets the code that it chooses: the goimports and pgfmt versions that its go.mod or tools.mod pins as go tools, and its own dprint.json. The formatters turn off go.work, also in a trusted repo, because a symlink can put the go.work of another repo in effect. To trust a repo and all its worktrees, run this in the repo:

git trust

Trust a repo only when you trust each person who can push to it. git trust adds the repo root to laptop.trusted in ~/.gitconfig.local. To remove it:

git config --file ~/.gitconfig.local --unset laptop.trusted "$PWD"

Keyboard

Configure "System Settings > Keyboard":

  • Set "Key Repeat" to "Fast".
  • Set "Delay Until Repeat" to "Short".
  • Set "Modifier Keys > Caps Lock Key" to "^ Control".

Disable "Press and Hold" accent menu to allow key repeat for all keys:

defaults write -g ApplePressAndHoldEnabled -bool false

1.1.1.1 as DNS resolver

Set DNS resolver to 1.1.1.1, a fast, privacy-focused DNS service from Cloudflare:

  • Go to "System Settings > Network > Advanced... > DNS"
  • Click "+"
  • Enter "1.1.1.1"
  • Click "OK"
  • Click "Apply"

Binary malware scans

A macOS feature that scans new binaries for malware adds an extra ~2s on to every build of Go programs, disturbing its fast iteration cycle. Disable it by running:

sudo spctl developer-mode enable-terminal

Then:

  • Go to "System Settings > Privacy & Security > Developer Tools"
  • Select "Warp" as the terminal program.

About

Setup script and dotfiles

Resources

Stars

35 stars

Watchers

2 watching

Forks

Used by

Contributors

Languages