🏠 Dotfiles

Personal dotfiles for macOS and Linux (Manjaro/Arch).

What's included

• Shell: Fish (default) and Zsh (shortcuts, completions, vi keybindings)
• Terminal: WezTerm
• Editor: Zed (install from zed.dev or the App Store), Neovim
• Prompt: Starship
• Git: Cross-platform configuration with SSH signing
• AI: Pi coding agent (settings, global instructions, packages)
• Extras: Alacritty, window managers (LeftWM, Qtile)

Dependencies

macOS

brew install fish starship git fzf eza diff-so-fancy kubectx fisher neovim
brew install --cask wezterm font-0xproto-nerd-font
brew install pi-coding-agent  # Pi coding agent
# Zsh-only (optional)
brew install zsh-autosuggestions zsh-syntax-highlighting

Manjaro/Arch

sudo pacman -S fish starship git fzf eza diff-so-fancy kubectx
# Zsh-only (optional)
sudo pacman -S zsh-autosuggestions zsh-syntax-highlighting zsh-history-substring-search
yay -S wezterm-git
yay -S fisher   # if not available via pacman
yay -S ttf-0xproto-nerd

Installation

git clone https://github.com/michalkozak/dotfiles.git ~/dotfiles
cd ~/dotfiles
chmod +x setup.sh
./setup.sh

Manual setup

mkdir -p ~/.config
mkdir -p ~/.config/fish

# Core
ln -sf ~/dotfiles/.zshrc ~/.zshrc
ln -sf ~/dotfiles/config.fish ~/.config/fish/config.fish
ln -sf ~/dotfiles/.gitconfig ~/.gitconfig
ln -sf ~/dotfiles/.gitignore_global ~/.gitignore_global

# Apps
ln -sf ~/dotfiles/starship.toml ~/.config/starship.toml
ln -sf ~/dotfiles/.wezterm.lua ~/.wezterm.lua
ln -sf ~/dotfiles/git.plugin.zsh ~/.config/git.plugin.zsh

# Pi coding agent
mkdir -p ~/.pi/agent
ln -sf ~/dotfiles/pi/settings.json ~/.pi/agent/settings.json
ln -sf ~/dotfiles/pi/AGENTS.md ~/.pi/agent/AGENTS.md

# Optional
ln -sf ~/dotfiles/.alacritty.yml ~/.alacritty.yml
ln -sf ~/dotfiles/nvim ~/.config/nvim

# Neovim setup
# 1. Install vim-plug
curl -fLo ~/.local/share/nvim/site/autoload/plug.vim --create-dirs \
    https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
# 2. Install plugins
nvim --headless +PlugInstall +qall

ln -sf ~/dotfiles/leftwm ~/.config/leftwm      # Linux
ln -sf ~/dotfiles/qtile ~/.config/qtile        # Linux

Shell setup

Fish is the default shell. On macOS you need to add it to /etc/shells first:

# macOS – add fish to allowed shells and set as default
echo "$(which fish)" | sudo tee -a /etc/shells
chsh -s "$(which fish)"

# Linux – usually just:
chsh -s "$(which fish)"

Zsh is also fully configured if you prefer it:

chsh -s "$(which zsh)"

Fish plugins

This repo uses the excellent Fish Git plugin by jhillyerd. It adds helpful abbreviations and functions for Git workflows.

Install via Fisher (the setup script attempts this automatically if Fish is present):

# Ensure Fisher is installed
brew install fisher                             # macOS
# or: yay -S fisher                              # Arch/Manjaro
# or (official script):
# fish -c 'curl -sL https://git.io/fisher | source; and fisher install jorgebucaran/fisher'

# Install the Git plugin
fish -c 'fisher install jhillyerd/plugin-git'

Git setup

# Create work directories
mkdir -p ~/github ~/gitlab

# Copy GitHub config template
cp ~/dotfiles/.gitconfig-github ~/github/.gitconfig
# Edit ~/github/.gitconfig with your details

The .gitconfig uses includeIf to load directory-specific configs, so repos cloned into ~/github/ or ~/gitlab/ automatically pick up the right identity.

Pi (coding agent)

Configuration for pi, the terminal-based coding agent.

mkdir -p ~/.pi/agent
ln -sf ~/dotfiles/pi/settings.json ~/.pi/agent/settings.json
ln -sf ~/dotfiles/pi/AGENTS.md ~/.pi/agent/AGENTS.md

After linking, install packages listed in settings.json:

pi install npm:@sting8k/pi-vcc
pi install npm:@plannotator/pi-extension
pi install npm:@benvargas/pi-claude-code-use
pi install git:github.com/tomsej/pi-ext
pi install npm:@mjakl/pi-kagi-search
pi install git:github.com/MasuRii/pi-rtk-optimizer

Credentials (auth.json, kagi-search.json) must be set up manually on each machine.

Features

• Fish: Abbreviations (k, tf, ll, kx, bubu), vi key bindings, fzf integration
• Zsh: Fuzzy completions, history management, auto-suggestions, syntax highlighting
• Starship: Git status, language versions, Kubernetes context, shell indicator, command duration
• WezTerm: Custom colors, 0xProto font, key bindings
• Git: Directory-specific configs, 1Password SSH signing, diff-so-fancy pager

Troubleshooting

Zsh completions not working

rm -f ~/.zcompdump*
exec zsh

Fish: fzf integration missing

Ensure fzf is installed. The fish config sources fzf --fish | source to enable completions and keybindings.

Homebrew completions missing

brew completions link

Permissions (macOS)

chmod -R go-w "$(brew --prefix)/share"

Git diff pager not working

Make sure diff-so-fancy is installed — it's configured as the default pager in .gitconfig:

brew install diff-so-fancy     # macOS
sudo pacman -S diff-so-fancy   # Arch/Manjaro