Dotfiles

Personal dotfiles managed with GNU Stow and Nix, with support for macOS (Apple Silicon) and Linux.

Quick Start

curl -fsSL https://raw.githubusercontent.com/TheExeQ/dotfiles/main/scripts/install.sh | bash

For CI/automation, use the --yes flag to skip confirmations:

curl -fsSL https://raw.githubusercontent.com/TheExeQ/dotfiles/main/scripts/install.sh | bash -s -- --yes

To install to a custom directory, set DOTFILES_DIR:

DOTFILES_DIR=~/mydotfiles

What's Included

• Shell - Fish as default shell
• Editor - Neovim
• Terminal - Ghostty with custom theme
• Tools - Git, tmux, Python, and more
• System - Custom key remaps, Dock behavior, and shell preferences

See nix/flake.nix for the full system setup.

Structure

dotfiles/
bootstrap.sh # Interactive setup wizard
scripts/install.sh # One-liner remote installer
lib/ # Shell library modules
stow/ # Symlinked dotfile packages
nix/ # nix system files

How It Works

1. install.sh downloads and extracts the repo to ~/dotfiles (or $DOTFILES_DIR)
2. bootstrap.sh installs gum locally, then presents an interactive menu to set up your package manager and symlink dotfiles