Dotfiles Overview
=================

Overview of my personal dotfiles - a collection of configurations for a productive development environment

Date: February 7, 2026


Welcome to my personal dotfiles documentation. This is a collection of
configurations that I&#39;ve built up over years of tweaking my development
environment to maximize productivity and minimize friction.

## Philosophy

These dotfiles follow a few core principles:

- **Minimal friction** - Tools should get out of the way and let you work
- **Keyboard-centric** - Mouse usage is minimized
- **Portable** - Works across different machines and environments
- **Version controlled** - Everything is tracked and reproducible

## What&#39;s Included

### Shell &amp; Terminal

- &lt;a href=&quot;/zsh/&quot; class=&quot;wikilink&quot; data-title=&quot;zsh Configuration&quot; data-description=&quot;zsh shell configuration - my primary shell with autosuggestions, syntax highlighting, and custom functions&quot; data-date=&quot;2026-02-07&quot;&gt;zsh Configuration&lt;/a&gt; - Primary shell with extensive customization
- &lt;a href=&quot;/tmux/&quot; class=&quot;wikilink&quot; data-title=&quot;tmux Configuration&quot; data-description=&quot;tmux configuration for persistent terminal sessions with popup windows and session management&quot; data-date=&quot;2026-02-07&quot;&gt;tmux Configuration&lt;/a&gt; - Terminal multiplexer for persistent sessions
- &lt;a href=&quot;/kitty/&quot; class=&quot;wikilink&quot; data-title=&quot;kitty Terminal&quot; data-description=&quot;kitty - a fast, feature-rich, GPU-based terminal emulator&quot; data-date=&quot;2026-02-07&quot;&gt;kitty Terminal&lt;/a&gt; - GPU-accelerated terminal emulator
- &lt;a href=&quot;/wezterm/&quot; class=&quot;wikilink&quot; data-title=&quot;WezTerm&quot; data-description=&quot;WezTerm - a GPU-accelerated cross-platform terminal emulator&quot; data-date=&quot;2026-02-07&quot;&gt;WezTerm&lt;/a&gt; - Cross-platform terminal emulator

### Editors

- &lt;a href=&quot;/neovim/&quot; class=&quot;wikilink&quot; data-title=&quot;Neovim Configuration&quot; data-description=&quot;Neovim configuration with lazy.nvim for plugin management&quot; data-date=&quot;2026-02-07&quot;&gt;Neovim Configuration&lt;/a&gt; - Modal editor with extensive plugin ecosystem
- &lt;a href=&quot;/helix/&quot; class=&quot;wikilink&quot; data-title=&quot;Helix Editor&quot; data-description=&quot;Helix - a post-modern modal text editor&quot; data-date=&quot;2026-02-07&quot;&gt;Helix Editor&lt;/a&gt; - Post-modern modal editor

### Window Management

- &lt;a href=&quot;/hyprland/&quot; class=&quot;wikilink&quot; data-title=&quot;Hyprland Window Manager&quot; data-description=&quot;Hyprland - a dynamic tiling Wayland compositor&quot; data-date=&quot;2026-02-07&quot;&gt;Hyprland Window Manager&lt;/a&gt; - Dynamic tiling Wayland compositor
- &lt;a href=&quot;/awesome/&quot; class=&quot;wikilink&quot; data-title=&quot;Awesome Window Manager&quot; data-description=&quot;Awesome WM - a highly configurable X11 window manager&quot; data-date=&quot;2026-02-07&quot;&gt;Awesome Window Manager&lt;/a&gt; - Highly configurable X11 window manager

### Development Tools

- &lt;a href=&quot;/mise/&quot; class=&quot;wikilink&quot; data-title=&quot;mise Tool Management&quot; data-description=&quot;mise - the universal version manager for development tools&quot; data-date=&quot;2026-02-07&quot;&gt;mise Tool Management&lt;/a&gt; - Universal version manager for dev tools
- &lt;a href=&quot;/git/&quot; class=&quot;wikilink&quot; data-title=&quot;Git Configuration&quot; data-description=&quot;Git configuration with aliases, delta for diffs, and work/personal separation&quot; data-date=&quot;2026-02-07&quot;&gt;Git Configuration&lt;/a&gt; - Version control configuration
- &lt;a href=&quot;/gitui/&quot; class=&quot;wikilink&quot; data-title=&quot;gitui&quot; data-description=&quot;gitui - a blazing-fast terminal UI for git&quot; data-date=&quot;2026-02-07&quot;&gt;gitui&lt;/a&gt; - Terminal UI for git (primary)
- &lt;a href=&quot;/lazygit/&quot; class=&quot;wikilink&quot; data-title=&quot;Lazygit&quot; data-description=&quot;Lazygit - a simple terminal UI for git commands&quot; data-date=&quot;2026-02-07&quot;&gt;Lazygit&lt;/a&gt; - Alternative git TUI

### Status &amp; System

- &lt;a href=&quot;/waybar/&quot; class=&quot;wikilink&quot; data-title=&quot;Waybar&quot; data-description=&quot;Waybar - a highly customizable Wayland bar&quot; data-date=&quot;2026-02-07&quot;&gt;Waybar&lt;/a&gt; - Highly customizable Wayland bar
- &lt;a href=&quot;/polybar/&quot; class=&quot;wikilink&quot; data-title=&quot;Polybar&quot; data-description=&quot;Polybar - a fast and easy-to-use status bar for X11&quot; data-date=&quot;2026-02-07&quot;&gt;Polybar&lt;/a&gt; - Fast and easy-to-use status bar

### Utilities

- &lt;a href=&quot;/atuin/&quot; class=&quot;wikilink&quot; data-title=&quot;Atuin&quot; data-description=&quot;Atuin - a magical shell history with sync&quot; data-date=&quot;2026-02-07&quot;&gt;Atuin&lt;/a&gt; - Magical shell history
- &lt;a href=&quot;/starship/&quot; class=&quot;wikilink&quot; data-title=&quot;Starship Prompt&quot; data-description=&quot;Starship - minimal, fast, and customizable shell prompt&quot; data-date=&quot;2026-02-07&quot;&gt;Starship Prompt&lt;/a&gt; - Minimal, fast shell prompt
- &lt;a href=&quot;/fzf/&quot; class=&quot;wikilink&quot; data-title=&quot;fzf&quot; data-description=&quot;fzf - a command-line fuzzy finder&quot; data-date=&quot;2026-02-07&quot;&gt;fzf&lt;/a&gt; - Command-line fuzzy finder
- &lt;a href=&quot;/lf/&quot; class=&quot;wikilink&quot; data-title=&quot;lf&quot; data-description=&quot;lf - a terminal file manager written in Go&quot; data-date=&quot;2026-02-07&quot;&gt;lf&lt;/a&gt; - Terminal file manager
- &lt;a href=&quot;/yazi/&quot; class=&quot;wikilink&quot; data-title=&quot;Yazi&quot; data-description=&quot;Yazi - a terminal file manager&quot; data-date=&quot;2026-02-07&quot;&gt;Yazi&lt;/a&gt; - Alternative file manager
- &lt;a href=&quot;/zellij/&quot; class=&quot;wikilink&quot; data-title=&quot;Zellij&quot; data-description=&quot;Zellij - a terminal workspace with batteries included&quot; data-date=&quot;2026-02-07&quot;&gt;Zellij&lt;/a&gt; - Terminal workspace with batteries included

## Getting Started

If you&#39;re interested in using any of these configurations, check out the
&lt;a href=&quot;/getting-started/&quot; class=&quot;wikilink&quot; data-title=&quot;Getting Started&quot; data-description=&quot;Getting started with these dotfiles - installation and setup guide&quot; data-date=&quot;2026-02-07&quot;&gt;Getting Started&lt;/a&gt; guide for installation and setup
instructions.

## Structure

The dotfiles are organized by application, with each directory containing the
relevant configuration files:

```
.
├── zsh/           # Shell configuration
├── tmux/          # Terminal multiplexer
├── nvim/          # Neovim configuration
├── hypr/          # Hyprland window manager
├── mise/          # Dev tool management
└── ...
```

Each tool has its own documentation page covering setup, key features, and
customization options.

## Contributing

These are my personal configurations, but feel free to fork and adapt them for
your own use. If you find bugs or have suggestions, issues and pull requests are
welcome.