Setup and configuration for my terminal based developer workflow:
- Zsh for a shell,
- Nix for package management of shell programs,
- pyenv for Python,
- Neovim for text editing.
This repo should be cloned into $HOME and set as $XDG_CONFIG_HOME.
Setup an Ubuntu machine:
$ make setup-ubuntu OS=ubuntu
This will also setup dependencies with Nix.
Setup an macOS machine:
$ make setup-macos OS=macos
This will also setup dependencies with Nix.
Install uv and setup a global Python installation in a virtual environment:
$ make pythonUse GNU Stow to symlink dotfiles for Bash, Zsh, Tmux and Git:
$ make dotfiles OS=macos
Valid values for OS are macos, wsl or windows.
A script ./scripts/bootstrap-stow.sh will attempt to bootstrap Stow if it's not already available. Stow bootstrapping is not setup for Windows because Windows is awful.
You can run the setup without bootstrapping Stow with:
$ make dotfiles OS=macos -o bootstrap-stow
Install packages with Nix:
$ make nix-pkgs
This will setup dependencies with Nix from ./nix/flake.nix.
It will also install Nix itself. Nix doesn't like to be installed multiple times - you can avoid this step with:
$ make nix-pkgs -o setup-nix
Neovim config is in ./nvim. To use the Neovim setup, put this folder into $XDG_CONFIG_HOME.
I use Lazy for package management in Neovim - it will install packages when you first open the editor.
Had weird issue with the first execution of Kitty not loading the kitty.conf correctly - fixed with:
# ~/Library/LaunchAgents/setenv.XDG_CONFIG_HOME.plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>setenv.XDG_CONFIG_HOME</string>
<key>ProgramArguments</key>
<array>
<string>sh</string>
<string>-c</string>
<string>launchctl setenv XDG_CONFIG_HOME $HOME/dotfiles</string>
</array>
<key>RunAtLoad</key>
<true/>
</dict>
</plist>
$ launchctl load ~/Library/LaunchAgents/setenv.XDG_CONFIG_HOME.plist