<h2>The Problem</h2>
<p>Setting up a new machine is painful. Install the terminal, configure the shell, set up the editor, install tools, configure themes, remember aliases. Every developer does this dance, and most lose hours getting things "just right" only to forget what they did when the next machine comes along.</p>
<p>I wanted to run one command and get my entire environment, exactly as I left it, on any machine.</p>
<h2>What I Built</h2>
<p>An open source dotfiles repository managed with <a href="https://www.gnu.org/software/stow/">GNU Stow</a> that installs and configures a complete terminal environment with a unified <a href="https://github.com/catppuccin/catppuccin">Catppuccin Mocha</a> theme. One command, everything configured, idempotent and safe to re-run.</p>
<h2>The Journey</h2>
<p>This started as a backup of my <code>.zshrc</code>. It grew into a curated replacement for nearly every default CLI tool.</p>
<h3>What's Inside</h3>
<table>
<thead>
<tr>
<th>Category</th>
<th>Tool</th>
<th>What It Does</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Terminal</strong></td>
<td>Ghostty</td>
<td>GPU-accelerated terminal (fastest on macOS)</td>
</tr>
<tr>
<td><strong>Shell</strong></td>
<td>Zsh + Zinit</td>
<td>Fast shell with async plugin loading</td>
</tr>
<tr>
<td><strong>Prompt</strong></td>
<td>Starship</td>
<td>Git, language, and time context in prompt</td>
</tr>
<tr>
<td><strong>Multiplexer</strong></td>
<td>tmux</td>
<td>Split panes, persistent sessions</td>
</tr>
<tr>
<td><strong>Editor</strong></td>
<td>Neovim</td>
<td>Full IDE with LSP, autocomplete, fuzzy finder</td>
</tr>
<tr>
<td><strong>Navigation</strong></td>
<td>zoxide</td>
<td>Smart <code>cd</code> that learns your directories</td>
</tr>
<tr>
<td><strong>File Manager</strong></td>
<td>yazi</td>
<td>Terminal file browser with previews</td>
</tr>
<tr>
<td><strong>History</strong></td>
<td>atuin</td>
<td>SQLite-backed searchable command history</td>
</tr>
<tr>
<td><strong>Git</strong></td>
<td>lazygit + delta</td>
<td>Visual git TUI + beautiful diffs</td>
</tr>
</tbody>
</table>
<h3>Modern CLI Replacements</h3>
<p>Every old command aliased to a faster, better alternative:</p>
<table>
<thead>
<tr>
<th>You Type</th>
<th>Actually Runs</th>
<th>Upgrade</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>ls</code></td>
<td>eza</td>
<td>Icons, colors, git status</td>
</tr>
<tr>
<td><code>cat</code></td>
<td>bat</td>
<td>Syntax highlighting</td>
</tr>
<tr>
<td><code>rm</code></td>
<td>trash</td>
<td>Sends to trash (safe delete)</td>
</tr>
<tr>
<td><code>vim</code></td>
<td>nvim</td>
<td>Neovim with IDE features</td>
</tr>
</tbody>
</table>
<p>Plus ripgrep (<code>rg</code>), fd, dust, sd, and btop installed under their own names to avoid breaking scripts.</p>
<h2>What Building This Taught Me</h2>
<h3>1. GNU Stow is elegantly simple</h3>
<p>I tried symlink scripts, Ansible playbooks, and Nix. All overkill. GNU Stow does one thing: mirror a directory structure as symlinks. Each tool gets its own directory, <code>stow toolname</code> creates the links, <code>stow -D toolname</code> removes them.</p>
<pre><code>dotfiles/
├── zsh/
│   └── .zshrc          → ~/.zshrc
├── tmux/
│   └── .tmux.conf      → ~/.tmux.conf
├── nvim/
│   └── .config/nvim/   → ~/.config/nvim/
└── starship/
    └── .config/starship.toml → ~/.config/starship.toml
</code></pre>
<p>No templating language, no dependency resolution, no abstractions. Just filesystem conventions.</p>
<h3>2. Theme consistency matters more than individual tool choices</h3>
<p>Having Catppuccin Mocha across every tool (terminal, editor, tmux, git diffs, file manager) creates a surprisingly cohesive experience. The tools themselves matter less than them looking and feeling like they belong together.</p>
<h3>3. Idempotent installers prevent anxiety</h3>
<p>The installer backs up existing configs before overwriting. Running it twice does the same thing as running it once. This seems obvious, but most dotfile setups fail on re-runs. Making it safe to re-run meant I actually ran updates instead of letting configs drift.</p>
<h3>4. Aliasing carefully avoids breaking things</h3>
<p>I alias <code>ls</code> to <code>eza</code> because nothing breaks. But I don't alias <code>grep</code> to <code>ripgrep</code> because shell scripts depend on grep's exact flags. The principle: alias interactive commands, leave scriptable commands alone.</p>
<h2>The Bigger Realization</h2>
<p>Developer tooling is personal infrastructure. The hours invested in a good terminal setup pay dividends every single day. But the real value isn't the tools; it's the reproducibility. Knowing I can go from a blank machine to my full environment in under 10 minutes removes friction from everything else.</p>
<h2>What I'd Do Differently</h2>
<p>Add a machine-local config layer from the start. Some settings are universal (theme, aliases), but others are machine-specific (work vs. personal git email, proxy settings). I'd separate these earlier instead of manually editing after install.</p>
<h2>References</h2>
<ul>
<li><a href="https://www.gnu.org/software/stow/manual/">GNU Stow Manual</a></li>
<li><a href="https://github.com/catppuccin/catppuccin">Catppuccin Theme</a></li>
<li><a href="https://ghostty.org/">Ghostty Terminal</a></li>
<li><a href="https://neovim.io/doc/">Neovim Documentation</a></li>
</ul>
<h2>Links</h2>
<ul>
<li><strong>GitHub:</strong> <a href="https://github.com/Cyvid7-Darus10/dotfiles">dotfiles</a></li>
</ul>


Projects.

Dotfiles: One-Command Terminal Environment