dotfiles

Installation

• Install just

brew install just

• Create the symlink farm, and then after this we can use the global justfile

just -f ~/dev/dotfiles/.config/just/justfile stow

• Install packages

just -g install

• Set up the symlink farm using GNU Stow for managing dotfiles

just -g stow

• Install Claude Code config

stow -d ~/dev/dotfiles -t "$HOME" claude

• Install yazi plugins

just -g install-yazi

Tools

• just as a command runner

• GNU stow for managing dotfiles

• neovim (nightly) for text editing

• fish as a command-line shell

• fisher as a pluginer manager for fish

• wezterm for terminal emulator

• yazi as a file manager

• unar as Yazi's archive extractor

• lazygit for git TUI

• delta for git diff

• fzf for fuzzy finder

• television for fuzzy finding in terminal UIs

• sd for a better sed

• duf for a better df

• dust for a better du

• fd for a better find

• ripgrep for a better grep

• eza for a better ls

• bat for a better cat

• hyperfine for benchmarking

• zoxide for cd based on frecency

• uv as a drop-in replacement for pip

• mamba (via miniforge) as a drop-in replacement for conda

• mise for managing dev tools or runtimes (think about nvm, etc.)

• pixi as a multi-language package manager (thiking about conda)

• glow for markdown (.md) preview

• miller for CSV, TSV, and tabular JSON preview

• tokei for code statistics (LOCs, # of files, etc.)

• i3-gaps as a window management

• polybar for top bar

• compton for enabling transparency with urxvt, and shadows

• dunst for notification server

• Xbindkeys for binding special keys

• imagemagick for every possible image manipulation

• zathura as a PDF viewer

Git Ignore

We need to define a git filter to ignore specific lines, in this case, lines that contain the ;gitignore text. This is really useful for ignoring some credentials that might be present in the files.

git config filter.gitignore.clean "sed '/;gitignore\$/d'"
# or 
git config --global filter.gitignore.clean "sed '/;gitignore\$/d'"

Windows

Open Command Prompt with Administrator privileges.

Git

In Windows,

mklink "%USERPROFILE%\.gitconfig" "D:\dev\dotfiles\.gitconfig"

In WSL2,

sudo ln -s /mnt/c/Program\ Files/Git/usr/bin/gpg.exe /usr/local/bin/gpg
sudo ln -s gpg /usr/local/bin/gpg2

Wezterm

mkdir %USERPROFILE%\.config
mklink /D %USERPROFILE%\.config\wezterm D:\dev\dotfiles\.config\wezterm

Zed

Zed stores user config on Windows in %APPDATA%\Zed. Link the individual config files so local data under that directory, such as themes or generated state, can stay there.

Open Command Prompt with Administrator privileges.

mkdir "%APPDATA%\Zed"
mklink "%APPDATA%\Zed\settings.json" "D:\dev\dotfiles\.config\zed\settings.json"
mklink "%APPDATA%\Zed\keymap.json" "D:\dev\dotfiles\.config\zed\keymap.json"
mklink "%APPDATA%\Zed\tasks.json" "D:\dev\dotfiles\.config\zed\tasks.json"

Without Administrator privileges, move any existing %APPDATA%\Zed directory out of the way and use a directory junction instead.

move "%APPDATA%\Zed" "%APPDATA%\Zed.backup"
mklink /J "%APPDATA%\Zed" "D:\dev\dotfiles\.config\zed"

Television

Install Television with its file-listing and preview dependencies, then link its Windows config directory.

winget install --id alexpasmantier.television
winget install --id sharkdp.fd
winget install --id sharkdp.bat
mkdir "%LOCALAPPDATA%\television"
mklink /J "%LOCALAPPDATA%\television\config" "D:\dev\dotfiles\.config\television"

AutoHotkey

mklink "%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\mie.ahk" "D:\dev\dotfiles\AutoHotkey\mie.ahk"

Open PowerShell

PowerShell profile, a script that runs when PowerShell starts

New-Item -Path $PROFILE -ItemType SymbolicLink -Value D:\dev\dotfiles\PowerShell\profile.ps1