Dotfiles

Personal development environment configuration for macOS. Built for a zsh + tmux + neovim workflow.

Quick Start

# Clone the repo
git clone git@github.com:yourusername/dotfiles.git ~/dotfiles

# Install Homebrew packages
xargs brew install < ~/dotfiles/brew_leaves.txt
xargs brew install --cask < ~/dotfiles/brew_casks.txt

# Symlink configs
ln -sf ~/dotfiles/.zshrc ~/.zshrc
ln -sf ~/dotfiles/.tmux.conf ~/.tmux.conf
ln -sf ~/dotfiles/.gitconfig ~/.gitconfig
ln -sf ~/dotfiles/.config/nvim ~/.config/nvim
ln -sf ~/dotfiles/.config/alacritty ~/.config/alacritty
ln -sf ~/dotfiles/.config/pgcli ~/.config/pgcli
ln -sf ~/dotfiles/.ssh/config ~/.ssh/config
ln -sf ~/dotfiles/.claude ~/.claude

# Set up local configs (machine-specific, not tracked)
cp ~/dotfiles/.zshrc.local.example ~/.zshrc.local
cp ~/dotfiles/.ssh/config.local.example ~/.ssh/config.local
chmod 600 ~/.ssh/config.local
# Edit these with your SSH keys, hosts, paths

# Set up secrets (API tokens, passwords - not tracked)
cp ~/dotfiles/.secrets.example ~/.secrets
chmod 600 ~/.secrets
# Edit ~/.secrets with your actual values

File Structure

The repo uses a .local pattern to separate shareable configs from machine-specific settings:

File	Tracked	Purpose
.zshrc	Yes	Generic shell config
.zshrc.local	No	SSH keys, personal paths, project aliases
.ssh/config	Yes	Generic SSH settings
.ssh/config.local	No	Host definitions with real IPs
.secrets	No	API tokens, passwords

---

Shell (Zsh)

Config: .zshrc

Framework & Plugins

• oh-my-zsh - Zsh framework
• zsh-autosuggestions - Fish-like suggestions
• zsh-syntax-highlighting - Command highlighting
• zsh-history-substring-search - Better history search
• fzf-tab - Fuzzy completion

Key Aliases

Alias	Command	Description
j	zoxide	Smart directory jumping
vim	nvim	Neovim
lzg	lazygit	Git TUI
lzd	lazydocker	Docker TUI
dce	docker compose exec	Docker exec shortcut
dcu	docker compose up	Docker up shortcut
gpoh	git push origin HEAD	Quick push
glopen	-	Open git remote in browser
n	nvim .	Open nvim in current dir
tks	tmux kill-server	Kill tmux
tw	-	Rename tmux window to current dir
ask	claude -p (function)	Quick Claude prompt (no quotes)

Custom Functions

• ask - Quick Claude prompt: ask how to say hello in polish
• base64pbcopy - Base64 encode file to clipboard
• gitstrip / gitstripstdin - Convert git SSH URLs to HTTPS

---

Terminal Multiplexer (Tmux)

Config: .tmux.conf

Keybindings

Key	Action
Ctrl-a	Prefix (instead of Ctrl-b)
Ctrl-a c	New window (in current path)
Ctrl-a "	Split horizontal (in current path)
Ctrl-a %	Split vertical (in current path)
Ctrl-Shift-Left/Right	Reorder windows
Ctrl-a h/j/k/l	Navigate panes
Ctrl-a n/p	Next/previous window
Ctrl-a S	Send pane to window (prompt)
Ctrl-a J	Join marked pane to current window
Ctrl-a m	Mark pane (built-in)
Ctrl-a M	Clear mark (built-in)

Features

• Mouse support enabled
• Windows/panes start at index 1
• 50,000 line history
• GitHub-inspired color theme
• Auto-renumber windows
• Bell notifications: windows with activity highlight in red (passthrough enabled for terminal notifications)

---

Editor (Neovim)

Config: .config/nvim/

Built on LazyVim distribution.

Theme

• OneDark (deep variant)

Key Plugins

Plugin	Purpose
lazy.nvim	Plugin manager
neo-tree.nvim	File explorer
fzf-lua	Fuzzy finder
gitsigns.nvim	Git integration
git-blame.nvim	Inline git blame
mason.nvim	LSP installer
nvim-treesitter	Syntax highlighting
trouble.nvim	Diagnostics list
which-key.nvim	Keybinding hints
bufferline.nvim	Buffer tabs
lualine.nvim	Status line
vim-abolish	Smart substitution
vim-surround	Surround text objects

Custom Keymaps

• d deletes without yanking (use x to cut)
• Ctrl-k/j increment/decrement numbers
• <leader>go open file in git browser

---

Terminal Emulator (Alacritty)

Config: .config/alacritty/alacritty.toml

• Theme: Dracula
• Font: FiraCode Nerd Font Mono
• Features:
  • Option as Alt key (macOS)
  • Word jumping with Alt+Arrow
  • Line delete with Cmd+Backspace

---

Git

Config: .gitconfig

• Pager: delta - Syntax-highlighted diffs
• Merge style: diff3 (shows base)
• Color moved: enabled

---

Database (pgcli)

Config: .config/pgcli/config

PostgreSQL CLI with:

• Smart auto-completion
• Syntax highlighting
• Destructive command warnings
• 1000 row limit
• Keyring password storage

---

SSH

Config: .ssh/config

Host aliases for quick access (defined in ~/.ssh/config.local):

ssh prod          # instead of ssh root@x.x.x.x
ssh staging       # project shortcuts

---

Homebrew Packages

CLI Essentials

Tool	Description
bat	Cat with syntax highlighting
eza	Modern ls replacement
lsd	LSDeluxe - another ls replacement
fd	Fast find alternative
ripgrep	Fast grep alternative
fzf	Fuzzy finder
zoxide	Smart cd
tldr	Simplified man pages
jq	JSON processor
yq	YAML processor

Development

Tool	Description
neovim	Editor
tmux	Terminal multiplexer
lazygit	Git TUI
lazydocker	Docker TUI
git-delta	Better git diffs
gh	GitHub CLI
just	Command runner
pre-commit	Git hooks framework

Languages & Runtimes

Tool	Description
rbenv	Ruby version manager
node	Node.js
pnpm	Fast npm alternative
go	Golang
poetry	Python dependency management
pipx	Python CLI tools

Infrastructure & DevOps

Tool	Description
terraform	Infrastructure as code
opentofu	Terraform fork
ansible	Configuration management
kubectl	Kubernetes CLI
k9s	Kubernetes TUI
helm	Kubernetes package manager
kamal	Rails deployment
docker	Containers
dive	Docker image explorer

Cloud CLIs

Tool	Description
hcloud	Hetzner Cloud (in history)
aws	Amazon Web Services (in history)
gcloud	Google Cloud (in history)
heroku	Heroku CLI

Security & Networking

Tool	Description
sops	Encrypted secrets
age	Encryption tool
trufflehog	Secrets scanner
wpscan	WordPress scanner
mitmproxy	HTTP proxy
dog	DNS lookup
httpstat	HTTP timing
nmap	Network scanner (in history)

Media & Misc

Tool	Description
ffmpeg	Video processing
yt-dlp	Video downloader
silicon	Code screenshots
asciinema	Terminal recording
tokei	Code statistics
ncdu	Disk usage analyzer

---

macOS Apps (Casks)

Productivity

Cask	App	Description
raycast	Raycast	Spotlight replacement
rectangle	Rectangle	Window management
alt-tab	AltTab	Windows-style alt-tab
maccy	Maccy	Clipboard manager
hazeover	HazeOver	Distraction dimmer
obsidian	Obsidian	Note-taking

Development

Cask	App	Description
alacritty	Alacritty	GPU terminal
cursor	Cursor	AI code editor
zed	Zed	Fast code editor
docker	Docker	Containers
beekeeper-studio	Beekeeper Studio	Database GUI
bruno	Bruno	API client
charles	Charles	HTTP proxy/debugger

System & Utilities

Cask	App	Description
stats	Stats	Menu bar system monitor
monitorcontrol	MonitorControl	External display brightness
betterdisplay	BetterDisplay	Display management
linearmouse	LinearMouse	Mouse customization
hammerspoon	Hammerspoon	macOS automation
the-unarchiver	The Unarchiver	Archive extraction
keka	Keka	File archiver
balenaetcher	balenaEtcher	USB flasher
flameshot	Flameshot	Screenshots

Media

Cask	App	Description
iina	IINA	Video player
vlc	VLC	Media player
spotify	Spotify	Music
obs	OBS	Streaming/recording
cog	Cog	Audio player
eqmac	eqMac	System equalizer
audacity	Audacity	Audio editor
calibre	Calibre	E-book manager

Communication

Cask	App	Description
telegram	Telegram	Messaging
signal	Signal	Secure messaging

Browsers

Cask	App	Description
google-chrome	Google Chrome	Chrome browser
firefox	Firefox	Firefox browser

Security & Network

Cask	App	Description
bitwarden	Bitwarden	Password manager
nordvpn	NordVPN	VPN
wireshark	Wireshark	Network analyzer
cyberduck	Cyberduck	FTP/cloud client
ngrok	ngrok	Localhost tunneling

Other

Cask	App	Description
anki	Anki	Flashcards
flux	f.lux	Blue light filter
stretchly	Stretchly	Break reminder
qbittorrent	qBittorrent	Torrent client
bambu-studio	Bambu Studio	3D printing slicer
coolterm	CoolTerm	Serial terminal
flowvision	FlowVision	Image browser
claude	Claude	AI assistant

Manual Install

App	Description
Wally	ZSA keyboard firmware tool (not in Homebrew)

---

Secrets & Local Configuration

This repo uses a .local pattern to keep sensitive/machine-specific data out of version control:

File	Template	Contains
~/.secrets	.secrets.example	API tokens, passwords
~/.zshrc.local	.zshrc.local.example	SSH keys, personal paths, project aliases
~/.ssh/config.local	.ssh/config.local.example	Host definitions with real IPs

# Set up local files from templates
cp .secrets.example ~/.secrets && chmod 600 ~/.secrets
cp .zshrc.local.example ~/.zshrc.local
cp .ssh/config.local.example ~/.ssh/config.local && chmod 600 ~/.ssh/config.local

# Edit each with your values
nvim ~/.secrets ~/.zshrc.local ~/.ssh/config.local

---

Hammerspoon

Config: .hammerspoon/

Lua-based macOS automation:

• lgtv - LG TV control integration

---

Claude Code

Config: .claude/

Claude Code CLI configuration with smart notifications.

Features

• Always thinking enabled for extended reasoning
• Notification hooks - alerts when Claude needs input or completes a task
• Smart notification suppression - no alerts when actively viewing the tmux pane
• Terminal bell integration - tmux status bar highlights on activity (works with tmux bell settings above)

Hooks

Event	Sound	Trigger
Notification	Ping	Claude needs your input
Stop	Funk	Task completed

Dependencies

• terminal-notifier - macOS notifications (brew install terminal-notifier)

---

File Structure

dotfiles/
├── .claude/                 # Claude Code config & hooks
├── .config/
│   ├── alacritty/           # Terminal config
│   ├── nvim/                # Neovim (LazyVim)
│   └── pgcli/               # PostgreSQL CLI
├── .hammerspoon/            # macOS automation
├── .ssh/
│   ├── config               # Generic SSH settings (tracked)
│   └── config.local.example # Template for hosts (tracked)
├── .gitconfig               # Git config
├── .gitignore               # Repo ignores
├── .secrets.example         # Secrets template
├── .tmux.conf               # Tmux config
├── .zshrc                   # Shell config (tracked)
├── .zshrc.local.example     # Template for local settings (tracked)
├── brew_casks.txt           # GUI apps
├── brew_leaves.txt          # CLI tools
├── macos_setup.sh           # Full setup script
├── export_local.sh          # Export local configs for migration
├── import_local.sh          # Import local configs on new machine
└── README.md                # This file

# Not tracked (create from .example files):
~/.zshrc.local               # SSH keys, personal paths
~/.ssh/config.local          # Host definitions with IPs
~/.secrets                   # API tokens, passwords

---

New Machine Setup

1. Install Xcode CLI tools: xcode-select --install
2. Install Homebrew: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
3. Clone this repo: git clone git@github.com:yourusername/dotfiles.git ~/dotfiles
4. Run setup: cd ~/dotfiles && ./macos_setup.sh
5. Import local configs (see below) or customize from .example files
6. Restart terminal or source ~/.zshrc

---

Migrating Local Configs

Transfer your local configs (secrets, SSH hosts, etc.) between machines. Archives are encrypted with age using a passphrase.

On the old machine

cd ~/dotfiles
./export_local.sh
# Enter a passphrase when prompted
# Creates: ~/dotfiles_local_YYYYMMDD_HHMMSS.tar.gz.age

Transfer the archive

# Via SSH
scp ~/dotfiles_local_*.tar.gz.age newmachine:~/

# Or via AirDrop, USB, etc. (encrypted, safe to transfer)

On the new machine

# After running macos_setup.sh
cd ~/dotfiles
./import_local.sh ~/dotfiles_local_*.tar.gz.age
# Enter the same passphrase

# Delete the archive
rm ~/dotfiles_local_*.tar.gz.age

What's included

File	Contents
.secrets	API tokens, passwords
.zshrc.local	SSH keys to load, personal paths
.ssh/config.local	SSH host definitions
.gitconfig.local	Git name/email