50+ tool configs · 23 Catppuccin Mocha themed tools · 60 Git aliases · 6 Docker services · 31 Vim plugins

curl -fsSL https://raw.githubusercontent.com/gufranco/dotfiles/master/install.sh | bash

source ~/.zshrc
bat --version    # syntax-highlighted cat
eza --version    # modern ls

The installer detects your OS and architecture automatically. On macOS it installs Homebrew and runs the Brewfile. On Linux it uses apt, snap, and direct downloads.

Aliases activate only when the modern tool is installed:

Vim with 34 plugins managed by vim-plug:

CoC extensions: TypeScript, ESLint, Prettier, CSS, JSON, Shell, snippets, import-cost.

A ready-to-use debugger for Python and Node.js, linked and installed by install.sh.

Python uses the standard library pdb with a richer .pdbrc. The aliases dir, attrs, vars, src, and loc inspect objects and locals at the prompt, adapted from Trey Hunner's Customizing pdb with .pdbrc. breakpoint() is wired through python/debughook.py, which prefers pdbp, then ipdb, then falls back to stdlib pdb, so it never dies in a virtualenv that lacks the fancy debuggers. python/pythonrc is the PYTHONSTARTUP file: persistent REPL history and pretty-printed output.

Node.js gets the built-in V8 Inspector workflow plus an editor debugger. The ni, nib, and niw aliases drive node inspect and --inspect-brk for terminal and Chrome DevTools debugging. jsr opens a custom REPL from nodejs/repl-init.mjs with deep colorized inspection. Inside Neovim, nvim-dap attaches to the pwa-node adapter for breakpoints and stepping. The full command reference and keymaps live in nodejs/DEBUGGING.md.

Tmux with 7 plugins and vim-style keybindings:

60 aliases, performance-tuned config, and Catppuccin Mocha colors for diffs, status, branches, and blame:

Delta as the diff pager with line numbers, hyperlinks, and Catppuccin Mocha syntax theme. Histogram diff algorithm, zdiff3 merge conflicts, and automatic rebase on pull.

Docker development via Colima with auto-configured VM sizing:

Each service has -init, -start, -stop, -purge, and -terminal functions. Colima VM uses Apple's Virtualization.framework on macOS with Rosetta 2 for x86_64 container support on Apple Silicon.

SteamOS-parity Steam + Proton setup for NVIDIA hybrid GPU laptops. Installed automatically on amd64 Ubuntu systems.

After install, reboot (to boot the XanMod kernel and load scx_lavd) and run:

gaming-check    # verifies all components

Per-game Steam launch options (right-click game, Properties, Launch Options):

gaming-launch-options    # prints all recommended options

The standard option for most games:

prime-run gamemoderun mangohud %command%

These GPUs are GTX/MX (no tensor or RT cores), so DLSS and hardware ray tracing do not apply. The performance lever is FSR upscaling via gamescope: render below native and upscale.

One-time Steam setup: Settings, Compatibility, enable "Enable Steam Play for all other titles", select "Proton Experimental" or a GE-Proton version. Keep Settings, Downloads, Shader Pre-Caching enabled.

GE-Proton stays updated automatically via f5, which also rebuilds the controller DKMS modules after a kernel bump. Check protondb.com for per-game compatibility and areweanticheatyet.com before buying multiplayer titles.

If a game does not work: switch to GE-Proton in the game's Compatibility settings, check ProtonDB, or use protontricks <appid> --gui to install missing Windows components.

Most tools use the Catppuccin Mocha flavor with the mauve accent, vendored as git submodules from the official ports where the tool can load a theme from a path, and inlined from the official port or palette otherwise:

Theme submodules track upstream main; f5 updates them with git submodule update --remote. GoAccess is the only tool not pixel-exact: its HTML report supports only bright/dark built-ins, so it uses dark. cmus has no 24-bit color support, so it uses the nearest 256-color values.

Run f5 in any terminal to update everything at once:

1. Pulls latest dotfiles and submodules
2. Updates AWS configuration
3. Updates Vim plugins and CoC extensions
4. Updates Oh My Zsh, Zsh plugins, and Tmux plugins
5. Upgrades mise-managed runtimes (Node.js, Python, Ruby)
6. On macOS: runs brew update, brew upgrade, brew bundle, and Mac App Store updates
7. On Linux: runs apt update and apt dist-upgrade
8. Reloads Tmux and Zsh configs

All configs are symlinked by install.sh using safe_link, which is idempotent and creates parent directories automatically.

.dotfiles/
├── asciinema/        # Asciinema terminal recorder config
├── atuin/            # Atuin shell history config
├── bat/              # Bat config + Catppuccin Mocha theme
├── bottom/           # Bottom system monitor, Catppuccin Mocha styled
├── broot/            # Broot file manager, Catppuccin Mocha themed
├── cmus/             # cmus music player, Catppuccin Mocha themed
├── conky/            # Conky system monitor (Linux)
├── curl/             # Curl config
├── direnv/           # direnv per-directory env config
├── eza/              # eza (ls replacement) config + Catppuccin Mocha theme
├── fd/               # fd (find replacement) config
├── gh/               # GitHub CLI config
├── ghostty/          # Ghostty terminal + Catppuccin Mocha theme
├── git/              # Git config, hooks, message template, 60 aliases
├── glab/             # GitLab CLI config
├── glances/          # Glances system monitor config
├── gnupg/            # GPG config and public keys
├── goaccess/         # GoAccess web log analyzer config
├── htop/             # htop config
├── k9s/              # K9s Kubernetes dashboard + Catppuccin Mocha skin
├── kanata/           # Kanata keyboard remapper config
├── kitty/            # Kitty terminal + Catppuccin Mocha theme
├── lazydocker/       # Lazydocker config, Catppuccin Mocha
├── lazygit/          # Lazygit config, Catppuccin Mocha
├── mailcap/          # Mailcap config
├── mise/             # mise runtime manager (Node.js, Python, Ruby)
├── mutt/             # Neomutt email client + Catppuccin Mocha theme
├── nodejs/           # npm, yarn, pnpm configs + GPG-encrypted tokens
├── nvim/             # Neovim/Vim config + 31 plugins
├── obsidian/         # Obsidian notes config
├── readline/         # Readline config
├── ripgrep/          # Ripgrep config
├── ssh/              # SSH config and public keys
├── tealdeer/         # Tealdeer (tldr) config, Catppuccin Mocha
├── telnet/           # Telnet config
├── themes/           # Terminal themes (iTerm2)
├── tilix/            # Tilix terminal config
├── navi/             # Navi cheatsheet manager + custom cheats
├── newsboat/         # Newsboat RSS reader config
├── opencode/         # OpenCode AI config
├── ranger/           # Ranger file manager config
├── taskwarrior/      # Taskwarrior task manager, Catppuccin Mocha themed
├── thefuck/          # TheFuck command corrector config
├── tig/              # Tig git TUI, Catppuccin Mocha themed
├── tmux/             # Tmux config + 7 plugins
├── tmuxp/            # tmuxp session layouts
├── wget/             # Wget config
├── yazi/             # Yazi file manager + Catppuccin Mocha theme
├── zsh/              # Zsh: aliases, functions, paths, settings, infrastructure
├── Brewfile          # Homebrew packages, apps, and fonts
├── install.sh        # Cross-platform installer
└── LICENSE           # MIT

1. Create a directory: myapp/
2. Add config files
3. Add to install.sh:

   safe_link "$HOME/.dotfiles/myapp" "$HOME/.config/myapp"

Private keys and credentials are excluded via .gitignore. Only public GPG keys and SSH public keys are tracked. API tokens are stored as GPG-encrypted files and decrypted at shell startup with caching.

MIT since 2014.