ZSH Dotfiles Configuration

A comprehensive ZSH configuration using Antidote plugin manager for an enhanced shell experience. This repository provides a complete setup with modern tools, productivity plugins, and an extensive collection of aliases for efficient command-line workflows.

Overview

This ZSH configuration includes:

• Plugin Management: Antidote for fast, Git-based plugin management
• Enhanced Navigation: Directory jumping with zoxide, fuzzy finding with fzf
• Syntax Highlighting: Fast syntax highlighting for better readability
• Auto-completion: Enhanced tab completion with fzf integration
• Version Management: mise for managing programming language versions
• Prompt: Starship cross-shell prompt
• Extensive Aliases: 100+ aliases for common development tasks

Tools and Dependencies

This configuration relies on the following external tools:

Core Tools

• Homebrew - Package manager for macOS
• Antidote - ZSH plugin manager
• fzf - Fuzzy finder for command-line
• zoxide - Smart directory jumper
• mise - Multi-language version manager
• Starship - Cross-shell prompt

File and Text Tools

• eza - Modern replacement for ls
• bat - Cat with syntax highlighting
• ripgrep (rg) - Fast text search
• fd - Fast find alternative
• jq - JSON processor

Development Tools

• Neovim - Text editor (EDITOR)
• VS Code Insiders - Visual editor (VISUAL)
• Chezmoi - Dotfiles manager
• Overmind - Process manager
• tmux - Terminal multiplexer

ZSH Plugins

Plugins are managed via Antidote and configured in antidote_plugins.conf:

Completions

• mattmc3/ez-compinit - Easy completion initialization
• zsh-users/zsh-completions - Additional completions
• aloxaf/fzf-tab - Fuzzy tab completion
• MichaelAquilina/zsh-you-should-use - Alias reminder

Core Features

• belak/zsh-utils - Completion styles, editor bindings, history, utility functions
• zshzoo/macos - macOS-specific utilities
• romkatv/zsh-bench - ZSH benchmarking
• ohmyzsh/ohmyzsh - Extract plugin for archive handling

Fish-like Features

• zdharma-continuum/fast-syntax-highlighting - Syntax highlighting
• zsh-users/zsh-autosuggestions - Command auto-suggestions
• zsh-users/zsh-history-substring-search - History search with arrow keys

Repository Structure

zdotdir/
├── .zprofile              # Environment setup and tool configuration
├── .zshenv                # Environment variables for all ZSH sessions
├── .zshrc                 # Interactive shell configuration
├── .zstyles               # ZSH completion and plugin styles
├── antidote_plugins.conf  # Antidote plugin definitions
├── functions/             # Custom ZSH functions
│   ├── calculate_actions_stats
│   ├── fetch_action_stats
│   ├── grecent
│   ├── is-macos
│   └── os
└── rc.d/                  # Modular configuration files
    ├── 01_history.zsh     # History configuration
    ├── 02_dirs.zsh        # Directory stack configuration
    ├── 02_mise.zsh        # mise version manager setup
    ├── aliases.zsh        # All shell aliases
    ├── commands.zsh       # Custom shell functions
    ├── fzf.zsh           # FZF integration
    ├── history-substring-search.zsh
    ├── input.zsh         # Input/keybinding configuration
    ├── sharship.zsh      # Starship prompt setup
    └── zoixide.zsh       # Zoxide directory jumper setup

Key Files

• .zprofile - Sets up environment variables, tool paths, and initial configuration
• .zshrc - Main configuration file that loads plugins and sources rc.d files
• .zstyles - ZSH completion styling and antidote configuration
• antidote_plugins.conf - Defines all ZSH plugins to be loaded
• functions/ - Custom shell functions auto-loaded at startup
• rc.d/ - Modular configuration files for different aspects of the shell

Installation

1. Install required tools via Homebrew:

   brew install antidote fzf zoxide mise starship eza bat ripgrep fd jq neovim

2. Clone this repository to your ZSH directory:

   git clone https://github.com/andrewmcodes/zdotdir.git ~/.config/zsh

3. Set ZDOTDIR in your ~/.zshenv:

   export ZDOTDIR="$HOME/.config/zsh"

Aliases Documentation

This document provides a comprehensive list of all available aliases organized by category.

Navigation Aliases

Alias	Command	Description
....	cd ../../	Navigate up two directory levels
...	cd ../..	Navigate up two directory levels
..	cd ..	Navigate up one directory level
~	cd ~	Navigate to home directory

Chezmoi Aliases

Alias	Command	Description
cz.apply, chezA	chezmoi apply	Apply chezmoi changes
cz.diff, chezd	chezmoi diff	Show chezmoi differences
cz.edit, cheze	chezmoi edit	Edit chezmoi files
cz.readd, chezR	chezmoi re-add	Re-add files to chezmoi

TMUX Aliases

Alias	Command	Description
tmA	tmux attach -t	Attach to a tmux session
tmK	tmux kill-session -t	Kill a tmux session
tmL	tmux ls	List tmux sessions
tmN	tmux new-session -s	Create new tmux session
tmS	tmux switch -t	Switch tmux session

Yarn Aliases

Alias	Command	Description
y	yarn	Yarn shortcut
yA	yarn add	Add package
yAd	yarn add -D	Add dev dependency

Homebrew Aliases

Alias	Command	Description
brewd	brew doctor	Check system for potential problems
brewi	brew install	Install package
brewI	brew info	Show package info
brewl	brew list	List installed packages
brewL	brew leaves	List installed packages not dependencies
brewo	brew outdated	Show outdated packages
brewr	brew reinstall	Reinstall package
brews	brew search	Search packages
brewS	brew services	Manage brew services
brewu	brew update	Update brew
brewU	brew upgrade	Upgrade packages
brewUp	brew update && brew upgrade && brew cleanup	Full system update
brewx	brew uninstall	Uninstall package
brewX	brew uninstall --force	Force uninstall package

Cask Aliases

Alias	Command	Description
caski	brew install --cask	Install cask
caskl	brew list --cask	List installed casks
casko	brew outdated --cask	Show outdated casks
caskr	brew reinstall --cask	Reinstall cask
casks	brew search --cask	Search casks
caskU	brew upgrade --cask	Upgrade casks
caskx	brew uninstall --cask	Uninstall cask
caskX	brew uninstall --cask --force	Force uninstall cask
caskz	brew uninstall --cask --zap	Zap uninstall cask

History Aliases

Alias	Command	Description
hisT	`history	tail`
hisG	`history	grep`

Rails Aliases

Alias	Command	Description
r	rails	Rails shortcut
rc	rails console	Rails console
rDbc	rails dbconsole	Database console
rT	`rails -T	awk '{print $2}'
rdm	rails db:migrate	Run pending migrations
rG	rails generate	Rails generator
rR	rails routes	List all routes
rRg	rails routes -g	Filter routes by grep
rRc	rails routes -c	Filter routes by controller
rs	rails server	Start Rails server

File Management Aliases

Alias	Command	Description
tree	eza --tree --git --group-directories-first	Display directory tree
ls	eza --icons --group-directories-first	List files
lsa	eza -a --icons --group-directories-first	List all files
lt	eza -T --group-directories-first --icons --git	Tree view
lta	eza -Ta --group-directories-first --icons --git	Tree view (all files)
ll	eza -lmh --group-directories-first --color-scale --icons	Long list format
la	eza -lamhg --group-directories-first --color-scale --icons --git	Long list all files
laa	eza -lamhg@ --group-directories-first --color-scale --icons --git	Long list with extended attributes
lx	eza -lbhHigUmuSa@ --group-directories-first --color-scale --icons --git --time-style=long-iso	Detailed list

Git Aliases

Alias	Command	Description
g	git	Git shortcut
ga	git add	Stage changes
gb	git branch	List branches
gbd	git branch -d	Delete branch
gc	git commit	Commit changes
gcm	git commit -m	Commit with message
gco	git checkout	Checkout
gd	git diff	Show changes
gl	git log	Show commit logs
gp	git push	Push changes
gpf	git push --force-with-lease	Force push (safely)
gpl	git pull	Pull changes
gr	git rebase	Rebase
grbc	git rebase --continue	Continue rebase
gs	git status	Show status
gundo	git reset --soft HEAD~1	Undo last commit
gup	git pull --rebase	Pull with rebase
gupm	git pull --rebase origin main	Pull main with rebase
gwip	git add -A; git commit -m 'chore: wip'	Commit work in progress

Utility Aliases

Alias	Command	Description
cat	bat	Enhanced cat with syntax highlighting
fDir	fd -H --type d | fzf || echo .	Interactive directory search
dutiA	duti -v "${XDG_CONFIG_HOME:-$HOME/.config}/duti"	Set default applications
jason	pbpaste -Prefer txt | jq . | pbcopy	Format clipboard JSON
c	code .	Open VS Code in current directory
ci	code-insiders	Open VS Code Insiders
ci.	code-insiders .	Open VS Code Insiders in current directory

Overmind Aliases

Alias	Command	Description
oC, oc	overmind connect	Connect to Overmind process
oCw, ocw	overmind connect web	Connect to web process
oK, ok	overmind kill	Kill Overmind processes
oRw	overmind restart web	Restart web process

Heroku Aliases

Alias	Command	Description
heroRc	heroku run rails c	Run Rails console on Heroku
heroRC	heroku run rails c -a podia -- -- --noautocomplete	Run Rails console on Heroku (Podia)

Bundle Aliases

Alias	Command	Description
b	bundle	Bundle shortcut
be	bundle exec	Execute bundled command
up	git pull && bundle check || bundle && yarn && rails db:migrate	Update project