Dotfiles

Make + symlinks · macOS + Linux

Quick start

Copy this one-liner to clone the repository, initialize the native OS configuration, and install uv and Python:

curl -fsSL https://raw.githubusercontent.com/lanej/dotfiles/master/install.sh | sh

Requires Git, Make, and Bash on macOS or Linux. An existing ~/.files checkout is reused without pulling updates or changing branches. Read the installer before running it.

Then choose this machine’s tool sets in ~/.config/dotfiles/config.toml, for example workstation for the broad setup. From the checkout, preview and install that selection:

make plan && make install

Find your next step

Compose your setup

Git, shell, and terminal tools are defaults. Add optional bundles and private sets, then override what this machine needs.

Work in the terminal

Sessions, pane navigation, and the important difference between tmux copying and Zellij scrollback.

Know where things live

Follow configuration from machine TOML to tool recipes, installers, and linked files.

Explore the stack

Shell, Neovim, Kitty, multiplexers, AI tooling, and platform-specific configuration.

Tech radar

My tool decisions at a glance: what I use, what I’m exploring, and what I’ve set aside.

Configure first. Install deliberately.

Command	What it does
make base	Create a missing machine configuration and link the native OS baseline.
make bootstrap	Apply the native baseline and provision uv and Python.
make plan	Show the tools and configuration selected by this machine’s settings.
make install	Install the selected tools and apply their configuration.

After setup, make reapplies the resolved configuration without installing packages. Follow the installation guide for prerequisites and machine settings.

The reference pages are built directly from this checkout’s documentation. Their Edit page links lead to the original source, so the website and repository stay in step.