_______/ |_ ____ ____ ________
/ ___/\ __\/ __ \_/ __ \\___ /
\___ \ | | \ ___/\ ___/ / /
/____ > |__| \___ >\___ >_____ \
\/ \/ \/ \/

st-eez dotfiles

Reproducible macOS workstation: shell, editor, terminal, window management.

Theme: Tokyo Night (switchable) | Font: JetBrainsMono Nerd Font

---

Prerequisites

# Homebrew (will prompt for Xcode CLI tools if needed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# GNU Stow
brew install stow # macOS# sudo apt install stow # Ubuntu/Debian# sudo pacman -S stow # Arch

---

Quick Start

git clone https://github.com/st-eez/dotfiles.git ~/dotfiles
cd~/dotfiles
# Interactive installer (handles Oh-My-Zsh, plugins, stow, and packages)
./install.sh
# Git config (edit name/email after copying)
cp ~/dotfiles/git/.gitconfig.template ~/.gitconfig

Machine-Specific Config

Create ~/.zshrc.local for paths specific to this machine:

# Example for Mac with Bitwarden SSH agentexport PATH="$HOME/.antigravity/antigravity/bin:$PATH"export SSH_AUTH_SOCK="$HOME/Library/Containers/com.bitwarden.desktop/Data/.bitwarden-ssh-agent.sock"

Linux-Only Install

Run ./install.sh — it handles --no-folding flags, ~/.zshenv bootstrap, and package-specific setup automatically.

How CLI Tools Are Managed

• Brewfile is the macOS package declaration for Homebrew-installed CLIs and apps.
• installer/config.sh is the package catalog that powers ./install.sh.
• If you want a CLI to be reproducible on a new Mac, add it to both files instead of checking binaries into the repo.
• Tool-specific runtime state under $HOME, such as ~/.agents/skills, is install output and should not be treated as dotfile source.

---

Post-Install

Restart your shell to apply changes:

exec zsh

First launch: Open Aerospace and Karabiner Elements — grant Accessibility access when prompted (System Settings → Privacy & Security → Accessibility).

Edit ~/.gitconfig with your name and email.

---

What's Included

Directory	Description
aerospace/	Tiling window manager with home/office/laptop profiles
sketchybar/	Custom menu bar with workspace indicators
nvim/	LazyVim-based Neovim config
ghostty/	Terminal emulator settings
zsh/	Oh-My-Zsh + Starship prompt
karabiner/	Caps Lock → Escape (tap) / Alt (hold)
raycast/	Keybind search extension
pi/	Pi coding agent settings, skills, and extensions
borders/	Window border styling
Brewfile	All packages and apps

---

Theming

Switch themes across all apps with one command:

theme-set tokyo-night # Default
theme-set gruvbox
theme-set everforest
theme-set osaka-jade
theme-set vantablack

Applies to: SketchyBar, Ghostty, Borders, Neovim, Obsidian, wallpaper.

Theme	Background	Accent
Tokyo Night	#1a1b26	Blue
Gruvbox	#1d2021	Orange
Everforest	#2d353b	Green
Osaka Jade	#111c18	Jade
Vantablack	#0d0d0d	Silver

Theme authoring source of truth is themes/sources/<theme-id>.toml; generated artifacts in themes/meta/, themes/configs/, themes/themes.json, and themes/wallpapers/<theme-id>/1-solid.png should not be edited by hand.

DOTFILES="$HOME/Projects/Personal/dotfiles"
python3 "$DOTFILES/themes/scripts/theme_build.py" --check
python3 "$DOTFILES/themes/scripts/theme_build.py" --generate-meta
python3 "$DOTFILES/themes/scripts/theme_build.py" --generate-themes-json
python3 "$DOTFILES/themes/scripts/theme_build.py" --generate-configs
python3 "$DOTFILES/themes/scripts/theme_build.py" --generate-wallpapers
git diff --exit-code -- "$DOTFILES/themes/meta""$DOTFILES/themes/themes.json""$DOTFILES/themes/configs""$DOTFILES/themes/wallpapers"

See themes/README.md for adding custom themes.

---

Environment Profiles

Three monitor configurations for Aerospace. Local edits use skip-worktree (won't show in git status).

Profile	Keybind	Setup
Home	ctrl-alt-h	BenQ + Pixio + MacBook
Office	ctrl-alt-w	LG Ultrawide + MacBook + ASUS
Laptop	ctrl-alt-l	Single display

---

Private Config

• ~/.secrets – API keys, tokens (not tracked)
• ~/.pi/agent/.env and ~/.pi/agent/auth.json – Pi API keys/auth (not tracked)

---

Tips

• Super key:option is the main modifier for all keybinds
• View all keybinds: Raycast → "Search Keybinds"
• Fuzzy find + open in Neovim:fnvim
• Fuzzy find + cd:fcd
• Smart cd: Use z instead of cd (learns your habits)
• Git TUI:lazygit
• Caps Lock: Tap = Escape, Hold = Alt (hyper key)