roottool's dotfiles

ℹ️ Overview

This dotfiles repository is intended to be used for Debian or Ubuntu under WSL2.

🖥️ My environment

• Windows 11
• WSL2
  • Debian 12 (bookworm)

⚙️ Included Components

• Homebrew/brew
• chezmoi
• sheldon
• starship/starship
• mise
• Docker

📦 Package management policy

This repository uses two package managers with distinct roles:

• Homebrew (Brewfile): system-level tools, build dependencies, and CLI tools that don't need per-project version pinning (e.g. gcc, cmake, sheldon, starship, zsh).
• mise (dot_config/mise/config.toml.tmpl): language runtimes and CLI tools that benefit from version management (e.g. node, rust, eza, ripgrep, fzf).

When adding a new tool, prefer mise if it's a versioned runtime or a tool you might want to pin per-project; use Homebrew otherwise.

🔰 How to use

1. Clone this repository

2. Create ~/.gitconfig_local

   The example is example/.gitconfig_local.

3. Create ~/local.zsh

   The example is example/local.zsh.

4. Move to the cloned repository

5. Execute the install script

   chmod +x install-packages.sh
   ./install-packages.sh

6. Reboot your distribution

   mise-managed tools (see "Package management policy" above) become available automatically once the install script finishes running mise install; no manual mise trust step is needed since the config lives in the global ~/.config/mise/config.toml.

7. Make a GPG key for GitHub.

   If you want to manipulate Git in the GUI within VS Code, do the following.

8. Download Gpg4win

9. Create ~/.gnupg/gpg-agent.conf

   touch ~/.gnupg/gpg-agent.conf
   gpg-connect-agent reloadagent /bye

10. Reboot a gpg agent

    gpg-connect-agent reloadagent /bye