Dotfiles Management

Personal dotfiles repository management system with symlink-based deployment for development tools and applications.

Overview

This skill helps you work with a personal dotfiles repository (riku929hr/dotfiles) that uses symbolic links to deploy configurations to the home directory. The repository includes configurations for Neovim (AstroNvim v5+), WezTerm, Zsh, tmux, Git, and various development tools.

Architecture

**Configuration Management:**

**Key Technology Stack:**

Instructions

1. Repository Structure Analysis

When examining the dotfiles repository:

2. Setup and Installation

To set up or reinstall dotfiles:

1. Run `./setup.bash` to install and symlink all configurations

2. Use `brew bundle` to install Homebrew packages

3. Verify symlinks point correctly to `$HOME` locations

3. Neovim Configuration

When working with Neovim configs:

To modify plugins:

4. Code Quality Checks

Before committing changes:

1. Run `npm run secretlint` to check for exposed secrets

2. Run `npm run check-format` to verify Lua formatting

3. Use `npm run format` to auto-format Lua files

5. Development Tools

**tmux session manager:**

**Git workflow:**

**Runtime versions:**

6. Making Configuration Changes

When modifying configurations:

1. Edit files in the repository (not the symlinked locations)

2. Changes automatically reflect in `$HOME` due to symlinks

3. For new files, update `setup.bash` to include symlink creation

4. For new packages, add to `Brewfile`

5. Run quality checks before committing

7. Package Management

**Adding new packages:**

**Updating packages:**

Important Notes

Examples

**Setting up dotfiles on a new machine:**

```bash

git clone <repo-url> ~/dotfiles

cd ~/dotfiles

./setup.bash

brew bundle

```

**Adding a new Neovim plugin:**

1. Create `nvim/lua/plugins/my-plugin.lua`

2. Configure plugin spec

3. Run `npm run format`

4. Restart Neovim - lazy.nvim will install automatically

**Checking for secrets before commit:**

```bash

npm run secretlint

git add .

git commit -m "Update configs"

```