dotfiles

• Kaushik's minimal dotfiles.
• Goals:
  • keep it simple
  • keep it minimal
  • make it easily transferrable between machines
  • keep it resilient to frequent OS f*ckery

Instructions

one-time setup

On a new Mac, clone the repos first:

mkdir -p ~/dev/per
cd ~/dev/per

git clone https://github.com/kaushikgopal/dotfiles.git
git clone <aikado-repo-url> aikado

cd dotfiles
./.setup.sh

.setup.sh expects to run from inside this repo. It symlinks the tracked dotfiles into $HOME, installs the shared Brewfile/npm dependencies in bootstrap mode, sets up fish, and wires the agent config from ~/dev/per/aikado.

If aikado lives somewhere else:

AIKADO_DIR=/path/to/aikado ./.setup.sh

updates

Use .update.sh for regular Homebrew/npm maintenance after the machine is set up:

~/.update.sh

This runs the full maintenance path: Homebrew cleanup, Brewfile install, npm global CLI install, cask upgrades, brew update, and brew upgrade.

If you only changed npm global packages and do not want to run Homebrew maintenance:

~/.npm.sh

That installs or updates the CLIs listed in .npm-global-packages and ~/.npm-global-packages.local. .brew.sh and .npm.sh are lower-level helpers; the usual entry points are .setup.sh and .update.sh.

machine-specific Homebrew packages

Keep packages that should exist on every Mac in .brewfile.

For machine-local packages or experiments, manually create ~/.brewfile.local on that machine. It is intentionally untracked.

.brewfile loads ~/.brewfile.local when it exists, so .update.sh installs those packages and protects them from cleanup.

vim ~/.brewfile.local
~/.update.sh

./.setup.sh also installs local Brewfile entries when ~/.brewfile.local exists, but it skips cleanup/update/upgrade during bootstrap.

machine-specific npm packages

Keep npm global CLIs that should exist on every Mac in .npm-global-packages.

For machine-local npm CLIs or experiments, manually create ~/.npm-global-packages.local on that machine. It is intentionally untracked.

The npm helper installs packages from both files when the local file exists. .update.sh runs that helper.

vim ~/.npm-global-packages.local
~/.update.sh

adding to dotfiles

From the .gitignore file, you'll notice i ignore everything. This is intentional. In keeping with the above goals, i only add the things i feel necessary for my specific environment.

To add to this dotfiles repo:

git add -f .xxxx