.dotfiles

Here you will find my dotfiles, living in peace and harmony.

🔍 Overview

• OS: Arch Linux
• WM: Hyprland
• Launcher: Fuzzel
• Terminal: Ghostty by default, with Alacritty installed too
• Theme: Catppuccin (Frappe flavor)
• Shell: zsh with Starship prompt and Sheldon plugin manager
• Coding: VS Code, Zed, Codex, and Pi
• Note-taking: VS Code with Foam Extension

📦 Configuration

Follow the Arch Linux installation guide to set up your system.

Once Arch is installed and this repository cloned locally, run the make targets defined in the Makefile. Each target handles one part of the system.

Common targets:

make paru      # install paru AUR helper
make terminal  # shell, prompt, terminal config
make git       # git config
make fonts     # font setup
make code      # VS Code config
make zed       # Zed config
make agents    # agent config
make secrets   # gopass and secret sync setup
make hypr      # Hyprland config
make desktop   # desktop app flags/config
make system    # system config files

Environment Variables

• Secrets live in gopass with the store synced at ~/.secrets; run make secrets to install the sync service and timer.
• User session variables live in ~/.config/environment.d/*.conf.
• Per-project values go in a .env file in the project root. terminal/zshrc auto-loads .env on directory change if the file is owned by you.

🧰 Utility Scripts

The repository includes useful scripts in the scripts/ directory, including:

• run-maintenance-tasks: update and clean the system
• web-search / web-fetch: quick terminal web helpers
• dirty-dirs-git / pull-all-dirs: manage multiple git repositories
• record-audio, extract-subs, yt2srt: media helpers
• pi-sandbox, pi-agent-profile: Pi agent helpers

🔧 Post-Installation Steps

After setting up the basic configuration, run:

make post-installation

This prints the remaining manual checks that still need to be automated.

📜 License

MIT © David Gasquez