Warning: If you want to give these dotfiles a try, you should first fork this repository, review the code, and remove things you don’t want or need. Don’t blindly use my settings unless you know what that entails. Use at your own risk!

You can clone the repository wherever you want. (I like to keep it in ~/dotfiles.) The bootstrapper script will pull in the latest version and copy the files to your home folder.

git clone https://github.com/tabatkins/dotfiles.git && cd dotfiles && source bootstrap.sh

To update, cd into your local dotfiles repository and then:

source bootstrap.sh

(You might need to sudo apt install rsync first, depending on how your computer is already set up.)

Alternatively, to update while avoiding the confirmation prompt:

set -- -f; source bootstrap.sh

To install these dotfiles without Git:

cd; curl -#L https://github.com/tabatkins/dotfiles/tarball/master | tar -xzv --strip-components 1 --exclude={README.md,bootstrap.sh,.osx,LICENSE-MIT.txt}

To update later on, just run that command again.

If ~/.extra exists, it will be sourced along with the other files. You can use this to add a few custom commands without the need to fork this entire repository, or to add commands you don’t want to commit to a public repository.

A few reminders of extra stuff I need to do after downloading these files:

# git credentials
# Not in the repository, to prevent people from accidentally committing under my name
GIT_AUTHOR_NAME="Tab Atkins-Bittner"
GIT_COMMITTER_NAME="$GIT_AUTHOR_NAME"
git config --global user.name "$GIT_AUTHOR_NAME"
GIT_AUTHOR_EMAIL="jackalmage@gmail.com"
GIT_COMMITTER_EMAIL="$GIT_AUTHOR_EMAIL"
git config --global user.email "$GIT_AUTHOR_EMAIL"

These files assume that pyenv is being used to manage python versions and install locations. Remember to install Pyenv (probably using the automatic installer), then set it up with the appropriate versions (pyenv install --list, then pyenv install x.y.z for the specific versions you want, then pyenv global x.y.z and/or pyenv local x.y.z to select the installed versions.)

You will likely need to install some prereqs before it can build successfully. For example:

apt-get install -y make build-essential libssl-dev zlib1g-dev libbz2-dev liblzma-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev xz-utils tk-dev
pyenv install 3.13.0
pyenv global 3.13.0
pyenv install 3.9.20
cd ~/bikeshed
pyenv local 3.9.20

(If you don't do this, pip install will constantly complain about the install directory not being writable, and suggesting running with sudo. Don't do that.)

• cargo (then source .bashrc to get the environment set up)
• Possibly the GNU c toolchain: sudo apt install build-essential
• zoxide: cargo install zoxide --locked
• fzf
• delta: cargo install git-delta --locked
• ripgrep: cargo install ripgrep --locked