MokkeMeguru Dotfiles Manager

Provides expert guidance for working with a personal dotfiles repository that manages configurations for development tools across macOS and Arch Linux systems using automated installation and symlink deployment.

What This Skill Does

This skill helps you understand, modify, and maintain a dotfiles repository that:

Repository Architecture

Installation Pipeline

The installation follows a multi-stage pipeline:

1. **Entry Point**: `install.sh`

- Accepts `-o` flag for OS (`osx` or `arch`)

- Accepts `-l` flag to load bash configurations

- Example: `./install.sh -o osx -l`

2. **OS Initialization**: `etc/init/{os}/init.sh`

- OS-specific setup (Homebrew for macOS, pacman for Arch)

3. **Dependency Installation**: `dotfilesDepends.sh`

- Installs HackGen Nerd Font (custom script in `fonts/hackgen/`)

- Installs Babashka, clj-kondo, language version managers

- Installs shell tools (sheldon, starship)

- Installs editor tooling (Doom Emacs packages, Vim Vundle)

4. **Symlink Creation**: `dotfilesLink.sh`

- Creates symlinks from dotfiles directory to `$HOME`

- All modifications should be made in the dotfiles repo, not home directory

5. **Post-Installation**: `dotfilesAfter.sh`

- Plugin installation

- Directory creation

Configuration Files Structure

**Shell Configurations**:

**Editor Configurations**:

**Tool Configurations**:

Step-by-Step Instructions

When Installing Dotfiles

1. **Detect the target OS** by checking the system or asking the user

2. **Run the main installer** with appropriate flags:

```bash

# For macOS

./install.sh -o osx -l

# For Arch Linux

./install.sh -o arch -l

```

3. **After installation**, change the default shell:

```bash

chsh -s $(which zsh)

```

4. **Verify symlinks** were created correctly in `$HOME`

When Modifying Shell Configurations

1. **Never edit files in `$HOME` directly** - edit in the dotfiles repository

2. **For shared aliases**, edit `bash/.bashrc` (sourced by both shells)

3. **For Zsh-specific features**, edit `zsh/.zshrc`

4. **To add Zsh plugins**, edit `sheldon/plugins.toml` and run:

```bash

sheldon lock --update

```

5. **To customize prompt**, edit `starship/starship.toml`

When Working with Doom Emacs

1. **After modifying `packages.el`**, always run:

```bash

doom sync

```

2. **To upgrade Doom Emacs**:

```bash

doom upgrade

```

3. **To reload configuration without restarting**:

```bash

doom reload

```

4. **Key files**:

- `doom.d/init.el` - Enable/disable modules

- `doom.d/packages.el` - Declare packages

- `doom.d/config.el` - Customize settings, LSP configurations

When Working with Vim

1. **To install plugins** after modifying `vim/` configurations:

```bash

vim +PluginInstall +qall

```

2. **Vim uses Vundle** for plugin management

When Updating Dependencies

1. **Update Sheldon plugins**:

```bash

sheldon lock --update

```

2. **Update Rust tools** (Sheldon, Starship):

```bash

cargo install sheldon --locked

cargo install starship --locked

```

3. **Update language version managers** via their respective update commands (pyenv, rbenv, goenv, volta)

When Adding New Configuration Files

1. **Add the file** in the appropriate dotfiles subdirectory

2. **Update `dotfilesLink.sh`** to create a symlink for the new file

3. **If the file requires setup**, update `dotfilesDepends.sh` or `dotfilesAfter.sh`

4. **Test on both OSes** if the configuration is cross-platform

Environment Management

The repository manages these language environments:

Important Constraints

Examples

**Example 1: Installing dotfiles on a new macOS machine**

```bash

Clone the repository

git clone https://github.com/MokkeMeguru/dotfiles.git ~/dotfiles

cd ~/dotfiles

Run installation for macOS with bash config loading

./install.sh -o osx -l

Change default shell to zsh

chsh -s $(which zsh)

Log out and log back in

```

**Example 2: Adding a new Zsh plugin**

```bash

Edit sheldon configuration

vim sheldon/plugins.toml

Add plugin entry, e.g.:

[plugins.zsh-autosuggestions]

github = "zsh-users/zsh-autosuggestions"

Update plugins

sheldon lock --update

```

**Example 3: Updating Doom Emacs configuration**

```bash

Edit packages

vim doom.d/packages.el

Add package, e.g.:

(package! some-package)

Sync Doom to install new packages

doom sync

Edit configuration

vim doom.d/config.el

Reload configuration

doom reload

```