dotfiles

33 tool configs · 141 brew packages · 57 desktop apps · 72 Nerd Fonts · 19 Tokyo Night themed tools · 60 Git aliases · 6 Docker services · 18 Claude Code skills

Quick Start

Prerequisites

Install

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

Verify

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.

What Gets Installed

Shell

Modern Tool Replacements

Aliases activate only when the modern tool is installed:

Editor

Vim with 24 plugins managed by vim-plug:

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

Terminal Multiplexer

Tmux with 7 plugins and vim-style keybindings:

Git

60 aliases, performance-tuned config, and Tokyo Night colors for diffs, status, branches, and blame:

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

Infrastructure

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.

Claude Code

18 custom skills for AI-assisted development:

Plus 17 rule files covering code style, resilience, caching, API design, testing, security, database patterns, distributed systems, observability, debugging, git workflow, verification, LLM documentation references, infrastructure, pre-flight checks, and borrow-restore patterns.

Tokyo Night Theme

All tools use the Tokyo Night "Night" variant:

System Update

Run f5 in any terminal to update everything at once:

1. Pulls latest dotfiles and submodules
2. Updates Vim plugins and CoC extensions
3. Updates Oh My Zsh, Zsh plugins, and Tmux plugins
4. Updates Node.js LTS via NVM
5. On macOS: runs brew update, brew upgrade, brew bundle, and Mac App Store updates
6. On Linux: runs apt update and apt dist-upgrade
7. Reloads Tmux and Zsh configs

Symlink Map

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

On macOS, lazygit, lazydocker, k9s, and ghostty also get symlinks into ~/Library/Application Support/.

.dotfiles/
├── bat/              # Bat config + Tokyo Night theme
├── bottom/           # Bottom system monitor, Tokyo Night styled
├── claude/           # Claude Code: 17 rules, 18 skills, hooks, MCP
├── cmus/             # cmus music player, Tokyo Night themed
├── conky/            # Conky system monitor (Linux)
├── curl/             # Curl config
├── eza/              # eza (ls replacement) config + Tokyo Night theme
├── fd/               # fd (find replacement) config
├── gh/               # GitHub CLI config
├── ghostty/          # Ghostty terminal + Tokyo Night theme
├── git/              # Git config, hooks, message template, 60 aliases
├── glab/             # GitLab CLI config
├── gnupg/            # GPG config and public keys
├── htop/             # htop config
├── k9s/              # K9s Kubernetes dashboard + Tokyo Night skin
├── kitty/            # Kitty terminal + Tokyo Night theme
├── lazydocker/       # Lazydocker config, Tokyo Night
├── lazygit/          # Lazygit config, Tokyo Night
├── mailcap/          # Mailcap config
├── mutt/             # Neomutt email client + Tokyo Night theme
├── nodejs/           # npm, yarn, pnpm configs + GPG-encrypted tokens
├── readline/         # Readline config
├── ripgrep/          # Ripgrep config
├── ssh/              # SSH config and public keys
├── tealdeer/         # Tealdeer (tldr) config, Tokyo Night
├── telnet/           # Telnet config
├── themes/           # Terminal themes (iTerm2)
├── tilix/            # Tilix terminal config
├── tmux/             # Tmux config + 7 plugins
├── vim/              # Vim config + 24 plugins
├── wget/             # Wget config
├── yazi/             # Yazi file manager + Tokyo Night theme
├── zsh/              # Zsh: aliases, functions, paths, settings, infrastructure
├── Brewfile          # 141 packages, 57 apps, 72 fonts
├── install.sh        # Cross-platform installer
└── LICENSE           # MIT

Adding New Configs

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

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

Security

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.

License

MIT since 2014.