Skip to content

Installation

Justin Puah edited this page Jul 13, 2026 · 1 revision

Both platforms use a module-based installer: pick the tools you want, or install everything. Both support a dry run that previews changes without touching anything.

Windows — setup.ps1

git clone git@github.com:jinyeow/dotfiles.git $HOME/dotfiles
cd $HOME/dotfiles
.\setup.ps1 -Module all          # install everything
.\setup.ps1 -Module git,nvim     # or pick specific modules
.\setup.ps1 -Module all -DryRun  # preview without changes

Available modules: neovim, vim, powershell, git, bash, tig, tmux, zellij, psmux, yazi, curl, claude, codex, serena, context7, fastmail, lazygit, windowsterminal, bat, vscode, winget

Some modules need extra privileges: file symlinks require Developer Mode (skill/agent dirs are junctioned instead). The MCP modules (codex, serena, context7, fastmail) register servers in ~/.claude.json and are Windows-only.

Linux / WSL — setup.sh

git clone git@github.com:jinyeow/dotfiles.git ~/dotfiles
cd ~/dotfiles
./setup.sh -m all              # install everything
./setup.sh -m git,neovim       # or pick specific modules
./setup.sh -m all --dry-run    # preview without changes

Available modules: neovim, vim, powershell, git, bash, tig, tmux, zellij, curl, claude, lazygit, windowsterminal

Requirements — winget bootstrap (Windows)

On a fresh machine, run the winget bootstrap first to install all the underlying tools at once:

.\winget\packages.ps1 -DryRun  # preview
.\winget\packages.ps1           # install

Or install the core tools individually:

Tool Purpose Install
delta Git pager / diff viewer winget install dandavison.delta
fzf Fuzzy finder winget install junegunn.fzf
ripgrep Fast grep winget install BurntSushi.ripgrep.GNU
bat Syntax-highlighted cat winget install sharkdp.bat
zoxide Smart cd winget install ajeetdsouza.zoxide
lazygit Terminal git UI winget install JesseDuffield.lazygit
tig Terminal git browser winget install Jonas.Tig
jujutsu (jj) Git-compatible VCS (prompt-integrated) winget install jj-vcs.jj
Neovim 0.11+ Editor winget install Neovim.Neovim

See each tool's wiki page for full prerequisites and setup notes.


Source: README.md and setup.ps1 / setup.sh in the dotfiles repo.

dotfiles wiki

Getting started

Core (Windows)

Cross-platform

Claude Code & AI

Reference

Legacy (Linux)

Troubleshooting

Clone this wiki locally