Dotfiles

This project contains my personal dotfiles, managed by chezmoi. It sets up a consistent development environment across multiple machines.

Installation

To set up your dotfiles, use the mask command-line tool. All common tasks are defined in maskfile.md.

1. Install pixi:

   Follow their instruction in their website.

2. Install chezmoi and zsh:

   pixi global install chezmoi age mask

   • You may also need zsh, tmux or python>=3.13 if you don't have them already.

3. Move age.key to new machine

   rsync -aP ~/key.age machine:~/.config/chezmoi/

4. Initialize chezmoi:

   chezmoi init Pedrexus/dotfiles.git

5. Set zsh as default shell:

   mask shell

6. Install Global Dependencies:

   mask install

First Usage

After installation, you can start using your new shell and tools:

1. Start Zsh:

   zsh

2. Start Tmux:

   tmux

   Inside tmux, press Ctrl+A then I to install tmux plugin dependencies.

Technologies Installed

• chezmoi: Manages the dotfiles.
• zsh: A powerful shell.
• tmux: A terminal multiplexer.
• LazyVim: A Neovim setup.
• pixi: A package manager that does not need SUDO.

Troubleshooting

mask install fails due to Python version

If you encounter issues with mask install on systems with older Python versions (e.g., Python 3.9), it might be due to tomllib not being available. You can resolve this by installing a compatible Python version globally via pixi:

pixi global install python

This will install a recent Python version that includes tomllib, allowing the dependency installation script to run correctly.

compilation failed happens due to GCC not loaded

In HPC clusters, start running module purge and module load {packages} to add the necessary dependencies.