Vedant's Dotfiles

A meticulously crafted development environment with Catppuccin theming, modern CLI tools, and a powerful Neovim setup.

Screenshots

Features

Category	Tools	Description
Shell	Zsh + Oh-My-Zsh + Antidote	Fast shell with lazy-loaded plugins
Prompt	Powerlevel10k	Instant prompt with git status
Editor	Neovim + LSP	Full IDE experience with lazy.nvim
Terminal	Alacritty + tmux	GPU-accelerated terminal with sessions
Theme	Catppuccin Mocha	Consistent theme across all tools
File Manager	Yazi	Blazing fast TUI file manager
Git	Lazygit + diff-so-fancy	Beautiful diffs and TUI git
Search	fzf + fd + ripgrep	Lightning fast fuzzy finding
Navigation	Zoxide + Harpoon	Smart directory and file jumping
History	Atuin	Searchable shell history sync

Prerequisites

Before installation, ensure you have:

• macOS (tested on Sonoma) or Linux
• Git installed
• Internet connection for cloning submodules
• (Optional) Homebrew for package management
• (Optional) Nerd Font for icons (Fira Code recommended)

Installation

Quick Install (Minimal)

Core configs only (zsh, git, tmux) - perfect for servers:

git clone https://github.com/vedantrathore/dotfiles && cd dotfiles
./install minimal

Full Install

Everything including Neovim, modern CLI tools, and macOS settings:

git clone https://github.com/vedantrathore/dotfiles && cd dotfiles
./install full

Standard Install

Interactive installation with prompts:

git clone https://github.com/vedantrathore/dotfiles && cd dotfiles
./install

Tool Stack

Shell & Terminal

Tool	Purpose	Config
Zsh	Shell	zshrc
Oh-My-Zsh	Zsh framework	-
Antidote	Plugin manager	zsh_plugins.txt
Powerlevel10k	Prompt	p10k.zsh
Alacritty	Terminal	alacritty.toml
tmux	Multiplexer	tmux.conf

Modern CLI Replacements

Classic	Modern	Purpose
ls	eza	File listing with icons
cat	bat	Syntax highlighted cat
find	fd	User-friendly find
grep	ripgrep	Fast grep
cd	zoxide	Smart cd
top	bottom	System monitor
du	dust	Disk usage
curl	curlie	Curl with httpie syntax

Neovim Plugins

Plugin	Purpose
lazy.nvim	Plugin manager
telescope.nvim	Fuzzy finder
nvim-lspconfig	LSP configuration
nvim-cmp	Completion
treesitter	Syntax highlighting
gitsigns.nvim	Git decorations
which-key.nvim	Keybinding hints
harpoon	Quick file navigation
oil.nvim	File explorer

Directory Structure

dotfiles/
├── install                 # Installation script
├── install.conf.yaml       # Dotbot configuration (full)
├── install.minimal.yaml    # Dotbot configuration (minimal)
├── Brewfile               # Homebrew packages (full)
├── Brewfile.minimal       # Homebrew packages (minimal)
│
├── zshrc                  # Zsh configuration
├── zsh_plugins.txt        # Antidote plugin list
├── p10k.zsh               # Powerlevel10k config
├── exports                # Environment variables
├── aliases                # Shell aliases
├── functions              # Shell functions
│
├── gitconfig              # Git configuration
├── tmux.conf              # tmux configuration
├── alacritty.toml         # Alacritty configuration
│
├── nvim/                  # Neovim configuration
│   ├── init.lua           # Entry point
│   └── lua/
│       ├── options.lua    # Vim options
│       ├── keymaps.lua    # Key mappings
│       ├── lazy-bootstrap.lua
│       ├── lazy-plugins.lua
│       └── plugins/       # Individual plugin configs
│
├── ripgreprc              # ripgrep configuration
├── fdignore               # fd ignore patterns
│
├── ssh/                   # SSH config templates
│   └── config.template
│
├── gnupg/                 # GPG config templates
│   ├── gpg.conf.template
│   └── gpg-agent.conf.template
│
├── k9s/                   # Kubernetes dashboard
├── yazi/                  # File manager
├── atuin/                 # Shell history
│
├── cheatsheet.md          # Keyboard shortcuts reference
├── macos                  # macOS system preferences
│
└── vendor/                # Git submodules
    └── github/
        ├── dotbot/        # Dotbot installer
        └── antidote/      # Zsh plugin manager

Key Bindings

See cheatsheet.md for complete keyboard shortcuts.

Quick Reference

Key	Action
Ctrl+f	tmux-sessionizer
Ctrl+r	Atuin history search
Ctrl+g	Navi cheatsheet
Ctrl+y	Accept autosuggestion

Neovim Leader Keys

Key	Action
<leader>sf	Search files
<leader>sg	Live grep
<leader>ca	Code action
<leader>rn	Rename symbol

Customization

Local Overrides

Create ~/.zshrc.local for machine-specific configurations (not tracked in git):

# Example: Work-specific settings
export ANTHROPIC_BASE_URL="https://custom.api.endpoint"

Work Git Config

The gitconfig supports conditional includes. Create ~/work/.gitconfig:

[user]
    email = work@company.com

Updating

Pull latest changes and re-run installer:

cd ~/.dotfiles
git pull
./install

Troubleshooting

Neovim Health Check

:checkhealth

Reset Neovim Plugins

rm -rf ~/.local/share/nvim
rm -rf ~/.local/state/nvim
nvim  # Lazy will reinstall

Zsh Compinit Warnings

compaudit | xargs chmod g-w

Acknowledgments

• Dotbot - Dotfile bootstrapper
• Catppuccin - Consistent theming
• Kickstart.nvim - Neovim foundation
• Mathias Bynens - macOS defaults inspiration

License

MIT