Get Started

Migrating from the old dotfiles? run the following command to clean things up before you install: rm -rf ~/.znap ~/.asdf ~/.dotfiles Make sure to backup your ~/.ssh/config file as we're now managing that as part of this repo.

Github Access Token

In order to avoid any issues with rate limiting on the GH API, I recommend adding a personal access token to your shell env. You can do this by setting one of these env variables:

• CHEZMOI_GITHUB_ACCESS_TOKEN
• GITHUB_ACCESS_TOKEN
• GITHUB_TOKEN

Install chezmoi on your machine using the shell script.

We're installing it to the ~/.local/bin directory to accomodate as many Unix-style OSs as possible.

I recommend forking the repo into your own dotfiles repo and then using the below command to install chezmoi, clone the repo and apply it in one step.

Note: this one-liner assumes it is cloning a repo called dotfiles from the user $GITHUB_USERNAME, make sure that's what you call your fork. Otherwise, please check the chezmoi docs for how to specify a different repo name.

sh -c "$(curl -fsLS get.chezmoi.io)" -- -b $HOME/.local/bin init --apply $GITHUB_USERNAME

Usage

Common commands

# Update the destination directory to match the target state
chezmoi apply

# Update the destination directory and refresh external files manually
chezmoi apply -R

# Update the destination directory and refresh the init files `promptStringOnce`, etc.
chezmoi apply --init

# Print the diff between the target state and the destination state
chezmoi diff

# Pull and apply any changes
chezmoi update

# Upgrade chezmoi to the latest released version
chezmoi upgrade

# Launch a shell in the source directory
chezmoi cd

Optional Configs

High-Level Tools Overview

• zsh: shell of choice.
• zellij: tmux but modern, faster and with a more promising future.
• chezmoi: used to manage these dotfiles and apply updates.
• mise: install and manage multiple devtools versions (think nvm, but good and for almost all tools).
• alacritty: terminal emulator of choice.
• krew: kubectl plugins manager.
• k9s: kubectl TUI.
• bat: cat but modern.
• eza: ls clone, but modern, with colors and with icons.
• helix: nvim but simple and rust-based.

TODOS

• Hanlde Windows installs?
  • Krew
  • Starship

Useful Links

Some of these files were directly inspired by budimanjojo's dotfiles