dotfiles

Personal shell configuration for productive web development on macOS

📋 Overview

A curated collection of shell configurations, aliases, and functions optimized for Ruby/Rails, Node.js, Go, Elixir, and Docker development workflows. Built around Zsh with Prezto, featuring 100+ productivity aliases and seamless integration with modern tools like Graphite, 1Password commit signing, and Claude Code.

✨ Features at a Glance

Category	Highlights
Shell	Zsh + Prezto, jump shortcuts, FZF fuzzy finding
Git	90+ aliases, Graphite stacked diffs, 1Password SSH signing
Editor	Neovim with built-in cheatsheet, Cursor, Claude Code integration
Ruby/Rails	80+ aliases for Bundler, Rails, Rake, Rubocop, Capistrano
Go	Run, build, test, install, fmt aliases
Elixir	IEx, Mix aliases
JavaScript	npm, pnpm, Yarn, Bun aliases
DevOps	Docker, Docker Compose, Heroku, Homebrew, mise

📁 Repository Structure

~/.dotfiles/
├── zsh/                        # Shell config, aliases, functions
│   ├── .zshrc                  # Main Zsh configuration
│   ├── .zpreztorc              # Prezto framework settings
│   ├── aliases.sh              # Common aliases
│   ├── aliases_*.sh            # Domain-specific aliases (git, ruby, docker, go, etc.)
│   ├── aliases_local.sh.example  # Template for local aliases
│   ├── functions.sh            # Custom shell functions
│   └── functions_local.sh.example # Template for local functions
├── git/                        # Git config and global gitignore
├── ruby/                       # Ruby, Rails, IRB configuration
├── nvim/                       # Neovim configuration with cheatsheet
├── claude/                     # Claude Code settings, plugins, skills
├── cursor/                     # Cursor editor settings, keybindings, MCP
├── ghostty/                    # Ghostty terminal configuration
├── bin/                        # Helper scripts (alias_stats)
├── servers/                    # Lightweight shell config for remote Linux servers
├── Brewfile                    # Homebrew dependencies
├── setup.sh                    # Installation script
├── uninstall.sh                # Uninstallation script
└── archive/                    # Deprecated configs (vim, tmux)

🛠 Prerequisites

Required:

• macOS (tested on Sonoma+)
• Homebrew
• Zsh (default on modern macOS)

Recommended Tools:

Install all recommended tools at once with the included Brewfile:

brew bundle --file=~/.dotfiles/Brewfile

Or install individually:

Tool	Purpose	Install
mise	Version manager for Ruby, Node, Python	brew install mise
fzf	Fuzzy finder for shell history/files	brew install fzf
fd	Fast file finder	brew install fd
Neovim	Modern Vim	brew install neovim
Graphite	Stacked diffs workflow	brew install withgraphite/tap/graphite

🚀 Installation

git clone git://github.com/svyatov/dotfiles.git ~/.dotfiles
brew bundle --file=~/.dotfiles/Brewfile  # Install dependencies
~/.dotfiles/setup.sh
~/.dotfiles/claude/install-plugins.sh    # Install Claude Code plugins
~/.dotfiles/claude/install-skills.sh     # Install Claude Code skills

Setup script options:

Option	Description
--help	Show usage and list of symlinks
--dry-run	Preview changes without modifying anything
--confirm	Ask before creating each symlink

What the setup script does:

• Backs up existing configs (adds .orig extension)
• Creates symlinks from home directory to dotfiles
• Clones the Prezto framework
• Creates ~/.secrets for private environment variables
• Verifies all symlinks were created correctly

To uninstall:

~/.dotfiles/uninstall.sh            # Remove symlinks, restore backups
~/.dotfiles/uninstall.sh --dry-run  # Preview what would be removed

📂 Key Files Reference

Source	Symlinks to	Purpose
zsh/.zshrc	~/.zshrc	Main Zsh configuration
zsh/.zshenv	~/.zshenv	Environment variables
zsh/.zpreztorc	~/.zpreztorc	Prezto settings
git/.gitconfig	~/.gitconfig	Git configuration
ruby/.gemrc	~/.gemrc	RubyGems settings
ruby/.irbrc	~/.irbrc	IRB configuration
ruby/.railsrc	~/.railsrc	Rails generator defaults
nvim/init.vim	~/.config/nvim/init.vim	Neovim configuration
claude/settings.json	~/.claude/settings.json	Claude Code settings
claude/statusline-command.sh	~/.claude/statusline-command.sh	Claude Code status line
claude/CLAUDE.md	~/.claude/CLAUDE.md	Global Claude Code preferences
cursor/settings.json	~/Library/.../Cursor/User/settings.json	Cursor editor settings
cursor/keybindings.json	~/Library/.../Cursor/User/keybindings.json	Cursor keybindings
cursor/mcp.json	~/.cursor/mcp.json	Cursor MCP server config
ghostty/config	~/.config/ghostty/config	Ghostty terminal config

Tooling scripts (not symlinked):

File	Purpose
setup.sh	Install dotfiles (with --help, --dry-run, --confirm)
uninstall.sh	Remove dotfiles (with --help, --dry-run)
Brewfile	Homebrew dependencies (brew bundle)
claude/install-plugins.sh	Install Claude Code plugins
claude/install-skills.sh	Install Claude Code skills (with --force)
cursor/install-extensions.sh	Install Cursor extensions from list
bin/alias_stats	Alias usage stats with colorful grouped output

⚡ Jump Shortcuts

One of the most useful features: persistent directory bookmarks with tab completion. Instead of typing long paths or relying on shell history, bookmark your frequently-used directories once and jump to them instantly.

Command	Description
j name	Jump to bookmarked directory
ja name [-f]	Add bookmark for current directory (-f to overwrite)
jd name	Delete a bookmark
jl	List all bookmarks
jb	Jump back to previous location

Example workflow:

# You're deep in a project
cd ~/Projects/client-name/app/services/payments

# Bookmark it
ja pay

# Later, from anywhere:
j pay  # Instantly back to ~/Projects/client-name/app/services/payments

# See all your bookmarks
jl
#   pay  -->  ~/Projects/client-name/app/services/payments
#   api  -->  ~/Projects/main-api
#   dots -->  ~/.dotfiles

Bookmarks persist across sessions (stored as symlinks in ~/.jump_shortcuts) and support tab completion.

🌟 Highlight Aliases & Functions

Shell Functions

Function	Description
mkcd dir	Create directory and cd into it
u [dir]	Jump up to parent (with tab completion)
uu [dir]	Jump up two levels
cmdtop [n]	Show most-used commands (default: 10)
g	Smart git: runs git status when called without arguments
alias_stats [days]	Alias usage stats: used/unused grouped by file, suggestions
rncd app	Create new Rails app and cd into it

Common Aliases

Alias	Command	Description
v	nvim	Open Neovim
l	ls -lhAG	Detailed file listing
cl	clear	Clear terminal
q	exit	Exit shell
edf	nvim ~/.dotfiles	Edit dotfiles
shrl	exec $SHELL -l	Reload shell
myip	dig +short myip.opendns.com...	Show public IP
ai	claude --name "CC ($(shorten_path))"	Launch Claude Code (titled by cwd)
aiy	claude --dangerously-skip-permissions --name ...	Launch Claude Code, skip permission prompts
astats	alias_stats	Alias usage statistics
syu	ewu mise rtk && mup && bun upgrade && uv self update && uv tool upgrade graphifyy	System tool updates

Git Aliases (from .gitconfig)

Alias	Command	Description
g sts	git status --short --branch	Compact status
g co	git checkout	Checkout branch
g cob	git checkout -b	Create and checkout branch
g l	git log --graph --pretty=...	Pretty log graph
g df	git diff --word-diff	Word-level diff
g dfc	git diff --cached	Diff staged changes
g ps	git push -u	Push with upstream
g pl	git pull	Pull with rebase
g st	git stash	Stash changes
g sp	git stash pop	Pop stash
g rb	git rebase	Rebase
g rbi	git rebase --interactive	Interactive rebase
g brclr	git branch --merged | ...	Clean merged branches
g sync	Fetch upstream + merge + push	Sync fork with upstream

Graphite Aliases

Alias	Command	Description
gtc	gt create	Create stacked branch
gts	gt submit	Submit PR
gtss	gt submit --stack	Submit entire stack
gtm	gt modify	Amend current branch
gtre	gt restack	Restack branches
gtl	gt log	Show stack log
gtu	gt up	Move up the stack
gtd	gt down	Move down the stack
gtco	gt checkout	Checkout branch
gtdl	gt delete	Delete branch
gty	gt sync	Sync with remote

Code Archaeology Aliases

Alias	Description
gchurn	Top 20 most-changed files in the past year
gcontrib	Contributor commit counts
gbugs	Files most often touched by fix/bug commits
gvel	Commit velocity by month
gfire	Firefighting commits (revert/hotfix/emergency)
gfocus	Most-changed files in the last two weeks
gdchurn	Top 15 most-changed directories in the past year
gstale	Files least recently touched

Skills Aliases (npx skills)

Alias	Command	Description
ska	npx skills add	Add a skill
skrm	npx skills remove	Remove a skill
sku	npx skills update	Update skills
skl	npx skills list	List installed skills
skf	npx skills find	Find available skills
skc	npx skills check	Check skill status

Ruby/Rails Aliases

Alias	Command	Description
be	bundle exec	Run with bundler
bi	bundle install	Install gems
bu	bundle update	Update gems
bo	bundle outdated	Check outdated gems
r	bundle exec rails	Rails command
rce	rails credentials:edit	Edit credentials
rrg	rails routes | fzf -e	Search routes with fzf
rcp	bundle exec rubocop --parallel	Run Rubocop
rca	rubocop --autocorrect-all	Rubocop auto-fix
rk	rake	Run rake
ba	bundle-audit	Security audit
capsd	cap staging deploy	Deploy to staging
caprd	cap production deploy	Deploy to production

JavaScript Aliases

Alias	Command	Description
nrd	npm run dev	Run dev server
nrt	npm run test	Run tests
nrb	npm run build	Build project
mm	pnpm	pnpm shortcut
mmd	pnpm dev	pnpm dev server
bb	bun -b	Bun shortcut (bun-as-node)
bbx	bunx -b	bunx shortcut
bbr	bun -b run	Bun run script
bbd	bbr deploy	Bun run deploy
bbi	bun install	Bun install
bba	bun add	Bun add package
bbrm	bun remove	Bun remove package
bbo	bun outdated	Bun outdated
bbu	bun update	Bun update
bbc	bun create	Bun scaffold project

Go Aliases

Alias	Command	Description
gor	go run .	Run current package
gob	go build .	Build current package
got	go test ./...	Run all tests
gotr	go test -race ./...	Run tests with race detector
gotv	go test -v ./...	Run tests verbose
gom	go mod tidy	Tidy modules
gog	go get	Get package
goi	go install	Install package
gof	go fmt ./...	Format all files

Elixir Aliases

Alias	Command	Description
ie	iex	Interactive Elixir
im	iex -S mix	IEx with Mix project
mt	mix test	Run tests
mtt	mix test --trace	Run tests with trace

Yarn Aliases

Alias	Command	Description
y	yarn	Yarn shortcut
ya	yarn add	Add package
yu	yarn upgrade	Upgrade packages
yr	yarn run	Run script
yrb	yarn run build	Build project
yt	yarn test	Run tests

Docker Aliases

Alias	Command	Description
d	docker	Docker shortcut
di	docker images	List images
drmi	docker run --rm -it	Run interactive container
dcm	docker-compose	Compose shortcut
dcu	docker-compose up	Start services
dce	docker-compose exec	Exec in container

Homebrew Aliases

Alias	Command	Description
ew	brew	Brew shortcut
ewi	brew install	Install package
ewu	brew upgrade	Upgrade packages
ewuu	brew update	Update formulae
ewo	brew outdated	List outdated
ewd	brew doctor	Run diagnostics
ewc	brew cleanup	Clean up

mise Aliases

Alias	Command	Description
m	mise	mise shortcut
mi	mise install	Install runtime
mu	mise use	Set version locally
mug	mise use -g	Set version globally
mls	mise ls	List installed
mo	mise outdated	Check outdated
mup	mise upgrade	Upgrade runtimes
mr	mise run	Run task

🔐 Secrets

The setup script creates ~/.secrets which is automatically sourced by the shell. Use it for sensitive environment variables:

# ~/.secrets
export OPENAI_API_KEY="sk-..."
export GITHUB_TOKEN="ghp_..."
export DATABASE_URL="postgres://..."

Important: The shell warns if ~/.secrets has insecure permissions. Fix with:

chmod 600 ~/.secrets

This file is not tracked by git.

🏠 Local Customizations

For machine-specific configuration that shouldn't be committed, use these files (all gitignored and auto-sourced):

File	Purpose
~/.zshrc.local	Machine-specific shell config
zsh/aliases_local.sh	Local aliases
zsh/functions_local.sh	Local functions

Example templates are provided: copy aliases_local.sh.example or functions_local.sh.example and customize.

⌨️ Neovim Quick Reference

The Neovim config (nvim/init.vim) includes a built-in cheatsheet. Key custom mappings:

Mapping	Action
Space cc	Open Claude Code in split
Space ccr	Resume Claude Code session
Ctrl+h/j/k/l	Navigate between splits
Space q	Close window
Space y / Space p	System clipboard yank/paste
Alt+j/k	Move lines up/down
Space ve	Edit Neovim config

📜 License

MIT