Dotfiles

[!warning] WARNING This is a work in progress, use it at your own risk.

My personal configuration is for a Backend Developer, that loves to program in Ruby, and JavaScript. I like to keep my configuration simple and clean, mostly for NeoVim, Tmux and Zsh. I use stow to manage the dotfiles.

Requirements

• Install asdf.
  • Install Ruby
  • Install Node.js
  • Install Python
  • Install lua
• Build and Install Neovim.
• Install Tmux running brew install tmux.
• Install Oh My Zsh.
• Install stow running brew install stow.

I also have been documented my installation packages for Linux Mint and Mac M3, to make it easier to install next time I need to.

NeoVim

The nvim directory contains the configuration files for NeoVim.

To install the configuration files, just run the following command:

stow nvim

To remove the configuration files, just run the following command:

stow -D nvim

Config

The config directory contains the configuration files for different tools like bat, vscode, etc.

To install the configuration files, just run the following command:

stow config

While I investigate how to use stow with the vscode configuration files, you can use the following commands:

ln -s ~/.dotfiles/config/.config/Code/User/settings.json ~/Library/Application\ Support/Code/User
ln -s ~/.dotfiles/config/.config/Code/User/keybindings.json ~/Library/Application\ Support/Code/User

To remove the configuration files, just run the following command:

stow -D config

Home

The home directory contains a mix of configuration files for different tools like git, tmux, zsh, etc.

To install the configuration files, just run the following command:

stow home

To remove the configuration files, just run the following command:

stow -D home

Fonts

I can live with the default fonts, but I have some favorite fonts that you can find under the nocopy/fonts directory.

For Linux, just copy the fonts to ~/.local/share/fonts/. For MacOS, just double click the font file and install it.

AI Configuration

AI agent tools (Claude Code, OpenCode, Codex) share centralized instructions, skills, and config in ai/. This directory is not managed by stow — it has its own sync script.

# Create all symlinks
~/.dotfiles/ai/agents sync

# Remove all symlinks
~/.dotfiles/ai/agents unsync

First time cloning (includes submodules):

git clone --recurse-submodules git@github.com:JuanVqz/dotfiles.git ~/.dotfiles

See ai/README.md for full details.