Personal dotfiles managed with a validated symlink farm.

# Clone
git clone git@github.com:atalariq/dotfiles.git ~/Repos/dotfiles
# Deploy a full profile
cd ~/Repos/dotfiles
./setup.sh laptop

setup.sh is a thin wrapper around bootstrap.sh. The bootstrap script reads a profile, links files into $HOME, detects conflicts, and validates the result.

Default behavior is file-level symlinking. Modules can opt into scoped directory-level symlinks through module metadata when a subtree is intentionally managed as one unit. misc/scripts uses that for ~/.local/script.

Deployable modules now live under config/:

config/
 app/
 desktop/
 misc/
 system/
profiles/
docs/

A module is still addressed as <category>/<module> in the CLI:

./setup.sh use app/fish
./setup.sh undo app/kitty

Internally those resolve to config/app/fish and config/app/kitty.

Machine-specific JSON profiles live in profiles/. Each profile declares deployable modules with a flat modules array:

{
 "name": "laptop",
 "modules": [
 "app/kitty",
 "app/fish",
 "desktop/mango",
 "misc/scripts",
 "system/archlinux"
 ]
}

You can also pass a custom JSON config:

./setup.sh path/to/my-machine.json

# Install essentials (Arch)
sudo pacman -S git python fish
# Deploy dotfiles
git clone git@github.com:atalariq/dotfiles.git ~/Repos/dotfiles
cd ~/Repos/dotfiles
./setup.sh laptop

GitHub does not support "clone just one folder" directly. If you want a subset, use sparse checkout.

git clone --filter=blob:none --no-checkout git@github.com:atalariq/dotfiles.git ~/Repos/dotfiles
cd ~/Repos/dotfiles
git sparse-checkout init --cone
git sparse-checkout set config/app/fish profiles bootstrap.sh setup.sh README.md
git checkout main

That is the sane option when a module depends on multiple files.

mkdir -p ~/.config/fish
curl -fsSL https://raw.githubusercontent.com/atalariq/dotfiles/main/config/app/fish/.config/fish/config.fish \
 -o ~/.config/fish/config.fish

Use this only for truly standalone files. It is a bad fit for modules like Fish, Neovim, Yazi, or Noctalia that span multiple files.

The app/nvim module lives in this repo at config/app/nvim and owns two NVIM_APPNAME trees:

• nvim for the main config
• nvim-minimal for the fallback profile

The Fish helper at config/app/fish/.config/fish/conf.d/40-nvim.fish exposes the selector and aliases for those real profiles only.

Current AI/dev-agent setup is documented in docs/ai-tools.md.

That page covers:

• Hermes Agent
• OpenCode
• Codex CLI
• Gemini CLI
• Zed agent integration

• bash — bootstrap and scripts
• python3 — profile parsing and JSON validation during bootstrap

• fish — interactive shell config
• sops — secrets management
• age / rage — secrets key management