README.md

dot.files

🌌 Elegant dotfiles for the modern developer | Powered by GNU stow

🎨 A meticulously crafted development environment featuring:

• 🚀 Blazing-fast ZSH setup with custom plugins
• 🎯 Neovim config with LSP & treesitter
• 🖥️ Beautiful terminal setup (Ghostty, Tmux)
• 🎮 Git-centric workflow with LazyGit
• 🌟 Tokyo Night theme across all tools

✨ Zero-friction setup for macOS development environment

What's Included

• Shell Configuration
  • .zshrc - ZSH shell configuration
  • Custom ZSH configurations in .config/zsh/
• Development Tools
  • .gitconfig - Git configuration
  • .vimrc - Vim configuration
  • .config/nvim/ - Neovim configuration
  • .config/tmux/tmux.conf - Tmux configuration
• Terminal Utilities
  • .config/ghostty/ - Ghostty terminal configuration
  • .config/starship.toml - Starship prompt configuration
  • .config/bat/ - Bat (cat alternative) configuration
  • .config/eza/ - Eza (ls alternative) configuration
  • .config/lazygit/ - LazyGit configuration
  • .config/yazi/ - Yazi file manager configuration
  • .config/fastfetch/ - System information tool configuration

Shell Customization

Aliases

File Listing

Alias	Command	Description
l	eza -1A --group-directories-first --icons=always --tree --level=1	List files
la	eza -la --git --git-repos --group-directories-first --octal-permissions --time-style=long-iso --icons=always --tree --level=1	Detailed list with git info
tree	eza -A --tree --group-directories-first --icons=always	Tree view
t	l	Short alias for list

Tools

Alias	Command	Description
lg	lazygit	Open LazyGit
lzd	lazydocker	Open LazyDocker
tm	tmux	Open Tmux
yz	yazi	Open Yazi file manager
ff	fastfetch	System info
rg	rg --hidden --smart-case ...	Ripgrep with defaults
copypath	pwd | pbcopy	Copy working directory to clipboard
ssh	TERM=xterm-256color command ssh	SSH with compatible terminfo

System

Alias	Command	Description
reload	source ~/.zshrc	Reload ZSH configuration
c	clear	Clear terminal screen
man	batman	Open man pages with bat
rf	trash	Move to Trash
allowapp	sudo xattr -r -d com.apple.quarantine	Remove quarantine
dsclean	fd -H '^\\.DS_Store$' -tf -X rm	Remove .DS_Store files
lnclean	fd . --type l ...	Remove broken symlinks

Editors

Alias	Command	Description
e	$EDITOR	Open editor
E	sudo -e	Open editor as root

Services

Alias	Command	Description
cds	caddy start --config ~/.config/caddy/caddy.json	Start Caddy
cdx	caddy stop	Stop Caddy

AI

Alias	Command	Description
ccc	claude --dangerously-skip-permissions	Claude Code
xxx	codex --yolo	Codex
ooo	opencode	OpenCode

Functions

Function	Description	Usage
brew	Wrapper that auto-syncs Brewfile after install/uninstall	brew install <pkg>

Prerequisites

System Requirements

• macOS
• Homebrew
• GNU stow

Required Dependencies

These need to be installed manually:

• Zsh - Shell
• Antidote - Zsh plugin manager
• Ghostty - Terminal emulator
• Tmux - Terminal multiplexer
• fzf - Fuzzy finder
• fd - File finder
• bat - Cat clone with syntax highlighting
• bat-extras - Bat-powered man page viewer
• eza - Modern ls replacement
• zoxide - Smarter cd command
• starship - Cross-shell prompt
• fnm - Fast Node.js version manager
• git - Version control
• diff-so-fancy - Git diff enhancer
• lazygit - Git TUI
• yazi - Terminal file manager
• 1Password CLI - Password manager CLI
• Neovim - Text editor
• ripgrep - Fast text search

Installing

1. Prerequisites

Before installation, ensure you have:

• macOS installed
• Command Line Tools for Xcode: xcode-select --install
• Homebrew package manager
• GNU stow: brew install stow
• just: brew install just

2. Clone and Link Dotfiles

1. Clone this repository:

git clone git@gitlab.com:waosdx/dotfiles.git ~/.dotfiles
cd ~/.dotfiles

2. Create symlinks using GNU stow:

just link

3. Post-Installation

1. Install required dependencies:

just brew-install

2. Reload your shell:

source ~/.zshrc

Uninstalling

1. Remove Symlinks

Remove all symlinks created by GNU stow:

just unlink

2. Clean Up Package Managers

2. Remove Homebrew packages (optional):

# List all installed packages first
brew leaves

# Remove specific packages
brew uninstall tmux fzf fd bat eza zoxide starship fnm lazygit yazi ripgrep diff-so-fancy ...
brew uninstall --cask ghostty

3. Remove Configuration Files

Clean up remaining configuration files:

# Remove ZSH configuration
rm -rf ~/.zshrc ~/.zsh_history ~/.cache/antidote ~/.cache/zsh/antidote-plugins.zsh ~/.cache/zsh/antidote-post-completion-plugins.zsh

# Remove tool-specific configs
rm -rf ~/.config/ghostty
rm -rf ~/.config/nvim
rm -rf ~/.config/tmux
rm -rf ~/.config/yazi
rm -rf ~/.config/starship.toml
...