🦄 dotfiles 🛠️

⚠️ Personal configuration. Use at your own risk — no warranty whatsoever.

Modern zsh setup: zinit + starship + zoxide

🚀 Setup (new machine)

Simple mode (servers, headless Linux)

Installs core configs + system packages only.

git clone https://github.com/vforge/dotfiles.git ~/.dotfiles
cd~/.dotfiles && bash install.sh simple
exec zsh

Supports: Ubuntu, Debian, Raspberry Pi OS, CachyOS.

Workstation mode (macOS desktop)

Full setup: configs + Homebrew + apps + macOS defaults.

git clone https://github.com/vforge/dotfiles.git ~/.dotfiles
cd~/.dotfiles && bash install.sh work
exec zsh

zinit auto-installs on first launch if missing.

📦 Stack

Component	What it does	Docs
zsh	Shell	z.sh
zinit	Plugin manager (auto-installs)	GitHub
starship	Cross-shell prompt (~/.starship.toml)	starship.rs
zoxide	Fuzzy directory jumping (z proj<TAB>)	GitHub
zsh-autosuggestions	Inline command suggestions	GitHub
zsh-syntax-highlighting	Syntax highlighting in the shell	GitHub
zsh-history-substring-search	History search (Up/Down arrows)	GitHub
fzf	Fuzzy finder (Ctrl+T, Ctrl+R)	GitHub

🔧 Git productivity plugins

• supercrabtree/k — Search git log by keyword (k <keyword>) — GitHub
• peterhurford/git-it-on.zsh — Git helper aliases — GitHub
• skx/sysadmin-util — Sysadmin utility functions — GitHub

🔌 Tool integrations

• pnpm — PATH configured via pnpm installer snippet — pnpm.io
• Google Cloud SDK — Auto-loaded if installed — cloud.google.com/sdk
• LM Studio CLI (lms) — PATH added for local model inference — GitHub
• Pi coding agent — Personal Pi package + pissh notes — PI.md
• rbenv — Ruby version manager (loaded if available) — rbenv.github.io
• GRC — Colorizes unix tools (loaded if available) — GitHub

🔨 CLI Tools

Custom scripts in bin/ — git helpers, kubectl wrappers, SSH provisioning, and more. → Full list: TOOLS.md

🖥️ tmux

Persistent sessions, Vim-style navigation, Tokyo Night status bar, auto-save/restore. → Setup & keybinds: TMUX.md

🔄 Updating existing machine

From anywhere:

dotfiles-update # Pull + re-apply (auto-detects mode)
dotfiles-update simple # Force simple mode
dotfiles-update work # Force workstation mode

Or manually:

cd~/.dotfiles && git pull && bash install.sh

📝 Notes

• Node.js/Python shown in prompt only inside project directories
• Git repos show full path (not truncated to repo root)
• Old configs backed up as .backup on first run