A complete macOS development environment — Ruby/Rails, Elixir/Phoenix, Node/React, Python, Go, Rust, Zig — with your choice of Tokyo Night, Aura Dark, or Catppuccin Mocha theme applied everywhere.

More screenshots

Neovim (AstroNvim + Aura Dark)

lazygit

Theme Picker

Health Check

Shell Startup Profiler

Doctor (Auto-fix)

Git Log

Directory Listing (eza)

This setup is inspired by DHH's Omakub and his "Everything in one place, everything just works" philosophy. The goal is simple:

1. One Command Installation - From zero to productive development environment in minutes
2. Unified Theme - Choose Tokyo Night, Aura Dark, or Catppuccin Mocha — applied across 17 apps for visual consistency. If theme apply fails partway, all configs are automatically restored.
3. Keyboard-First - Vim motions, tiling windows, keyboard shortcuts for everything
4. Modular Configuration - Clean, organized configs that are easy to understand and modify
5. Developer Ergonomics - Tools chosen for speed, reliability, and joy of use

Like DHH's Omakub for Ubuntu, this setup provides:

• Opinionated but customizable - Great defaults, easy to change
• Battle-tested tools - Used daily for professional Rails and Elixir development
• Productivity-focused - Everything configured to minimize friction
• Beautiful aesthetics - Because we stare at code all day

Choose your theme during install — it's applied across 22 apps:

Switch anytime: dotfiles theme tokyo-night, dotfiles theme aura, or dotfiles theme catppuccin

• Ruby/Rails - mise, ruby-lsp, RuboCop, RSpec tasks, ERB formatting
• Elixir/Phoenix - mise, elixir-ls, mix integration, tailwindcss-language-server
• TypeScript/React - prettier, eslint, auto-imports, inlay hints
• Zig - zls (auto-installed), build/test/run tasks, 26 snippets
• Node.js - mise, npm/yarn
• Git - lazygit, fugitive, gitsigns

• Aerospace - i3-like tiling window manager for macOS
• Neovim + AstroNvim - Modern Vim distribution with LSP, Treesitter, Telescope
• tmux - Session management, vim integration, persistent sessions
• Zellij - Modern alternative to tmux with on-screen hints
• Starship - Fast, customizable prompt (16x faster than Spaceship)
• Harpoon - Quick file navigation (ThePrimeagen workflow)
• Smart CLI - cd uses zoxide (frecency), ls→eza, cat→bat, grep→ripgrep, find→fd

• Window Manager: Aerospace (i3-like tiling for macOS)
• Terminal: Ghostty (GPU-accelerated)
• Shell: zsh with modular configuration
• Prompt: Starship
• Multiplexers: tmux + Zellij
• Editors: Neovim with AstroNvim, Zed (settings, snippets, tasks)
• Version Control: Git (smart defaults, respects $EDITOR, per-directory identity), lazygit, GitHub CLI
• Work Management: work-setup, work-nuke, work-switch, work-status, repos-clone
• Dotfiles CLI: dotfiles update, dotfiles sync, dotfiles health, dotfiles theme, dotfiles add-theme, dotfiles cleanup, dotfiles doctor, dotfiles backup, dotfiles profile, dotfiles export
• Custom Scripts: ~/bin (erb-lint-formatter, etc.)

• mise - Modern version manager (replaces rbenv, nvm, asdf)
• Ruby (latest via mise)
• Elixir + Erlang (latest)
• Node.js (latest)
• Python 3
• Zig
• Go, Rust (latest)
• PostgreSQL 14
• MySQL
• Redis
• SQLite (via litecli)

• ripgrep, fd, fzf (fuzzy finding)
• bat (cat with syntax highlighting)
• eza (modern ls)
• tree (directory visualization)
• yazi (terminal file manager)
• lnav, tailspin (log viewers)

bash <(curl -fsSL https://raw.githubusercontent.com/AnjanJ/dotfiles/main/install.sh)

Or if you prefer to clone first:

git clone https://github.com/AnjanJ/dotfiles.git ~/dotfiles && bash ~/dotfiles/install.sh

Both are fully non-interactive with sensible defaults. No prompts, no questions — just run it.

bash install.sh --name "AJ" --email "aj@example.com" --theme aura bash install.sh --work-email "aj@corp.com" --ssh generate bash install.sh --interactive # Prompt for every choice (old behavior) bash install.sh --no-macos-defaults # Skip macOS system preferences bash install.sh --force # Force reinstall everything bash install.sh --help # Show all options

1. ✅ Install Homebrew (if not installed)
2. ✅ Install all packages from Brewfile
3. ✅ Create symlinks to dotfiles (shell, tmux, Neovim, Zed, ~/bin)
4. ✅ Apply your chosen theme (Tokyo Night, Aura Dark, or Catppuccin)
5. ✅ Set up tmux plugins
6. ✅ Configure Neovim
7. ✅ Configure Zed (settings, snippets, tasks)
8. ✅ Set up shell environment, Git defaults, and SSH keys
9. ✅ Apply macOS defaults
10. ✅ Run health check

💡 Truly idempotent — run it 10 times, get the same result. No backup clutter, no duplicate configs, no re-prompting.

📋 Want the full breakdown? See WHAT_GETS_INSTALLED.md — every tool, language, config, and system change explained step by step.

Installed Tools: ├── Window Management │ └── Aerospace (i3-like tiling) ├── Terminals │ └── Ghostty (GPU-accelerated) ├── Shell │ ├── zsh (modular configuration) │ └── Starship prompt ├── Multiplexers │ ├── tmux (with 8 plugins) │ └── Zellij ├── Editors │ ├── Neovim + AstroNvim │ └── Zed ├── Languages │ ├── Ruby + mise │ ├── Elixir + Erlang │ ├── Node.js │ ├── Python │ ├── Zig │ ├── Go │ └── Rust ├── Databases │ ├── PostgreSQL 14 │ ├── MySQL │ ├── Redis │ └── SQLite (litecli) ├── Dotfiles CLI │ ├── dotfiles update (upgrade & sync) │ ├── dotfiles sync (quick refresh — pull, relink, theme) │ ├── dotfiles health (verify setup) │ ├── dotfiles theme (switch theme) │ ├── dotfiles add-theme (scaffold new theme) │ ├── dotfiles cleanup (remove unlisted Homebrew packages) │ ├── dotfiles doctor (auto-fix issues) │ ├── dotfiles backup (snapshot/restore) │ ├── dotfiles profile (shell startup timing) │ ├── dotfiles export (portable setup snapshot) │ ├── dotfiles install (run installer) │ ├── dotfiles uninstall (remove symlinks) │ └── dotfiles edit / dir (open editor / print path) ├── Work Management │ ├── work-setup (configure work identity) │ ├── work-nuke (remove work config) │ ├── work-switch (change employer) │ ├── work-status (show current setup) │ └── repos-clone (clone from GitHub/GitLab/Bitbucket/Codeberg) ├── Custom Scripts │ └── ~/bin (erb-lint-formatter, etc.) └── Tools ├── Git + lazygit ├── ripgrep, fd, fzf └── bat, eza, tree 

The .zshrc is organized into focused, modular files:

~/.zshrc # Main config (loads everything) ~/.zshrc-dhh-additions # DHH-inspired workflows ~/.zshrc-elixir-additions # Elixir/Phoenix tools ~/.zshrc-terminal-enhancements # tmux, Zellij, Neovim aliases ~/.zshrc-work # Work-specific settings (optional) 

Why modular?

• Easy to understand and modify
• Enable/disable features by commenting one line
• Share common configs, keep private ones separate
• Inspired by DHH's clean, organized approach

dotfiles/ ├── .zshrc # Core: prompt, PATH, tool initialization ├── .zshrc-dhh-additions # Rails workflows, aliases, functions ├── .zshrc-elixir-additions # Elixir/Phoenix development ├── .zshrc-terminal-enhancements # Terminal multiplexers, editors ├── .zshrc-work # Work-specific (created by work-setup, not in repo) ├── .tmux.conf # tmux: sessions, vim integration, shortcuts ├── .config/ │ ├── aerospace/ # Window management: layouts, keybindings │ ├── ghostty/ # Terminal: theme, fonts │ ├── mise/ # Version manager (Ruby, Node, Elixir, etc.) │ ├── nvim/ # Editor: LSP, plugins, keymaps │ ├── zed/ # Zed: settings, snippets, tasks │ ├── zellij/ # Multiplexer: config, theme, layouts (rails, phoenix, work) │ ├── lazygit/ # Git UI: config + theme │ ├── borders/ # JankyBorders: active window highlighting │ ├── sketchybar/ # Menu bar: config + plugins │ └── starship.toml # Prompt: git, languages, colors ├── bin/ # Custom scripts (erb-lint-formatter, etc.) └── Brewfile # Declarative package management 

Each file has a single responsibility. Want to change your Rails workflow? Edit .zshrc-dhh-additions. Need different terminal aliases? Modify .zshrc-terminal-enhancements.

1. Restart your terminal

   source ~/.zshrc

2. Install tmux plugins

   tmux # Press: Ctrl+A then Shift+I

3. Open Neovim (plugins auto-install)

   nvim

4. Start Aerospace

   aerospace reload # Or: logout and login again

Note: Uses Ctrl+Shift for international keyboard compatibility (DHH-inspired)

App Launchers (Workspace-aware):

Browser Window Cycling (across all workspaces):

Zellij Layouts (pre-configured via aliases):

Choose between Tokyo Night (dark blue), Aura Dark (deep purple), or Catppuccin Mocha (warm pastels) during install. The theme is applied across 22 apps (17 auto-configured + 5 with manual instructions).

Browse the full galleries: Tokyo Night | Aura Dark | Catppuccin

Switch anytime: dotfiles theme tokyo-night, dotfiles theme aura, or dotfiles theme catppuccin

dotfiles/ ├── install.sh # Main installation script (idempotent) ├── update.sh # Update script for syncing changes ├── Brewfile # Homebrew packages (auto-generated) ├── README.md # This file ├── QUICK_REFERENCE.md # Cheat sheet ├── .zshrc # Main shell config ├── .zshrc-dhh-additions # Rails workflows ├── .zshrc-elixir-additions # Elixir/Phoenix ├── .zshrc-terminal-enhancements # Terminal tools ├── .tmux.conf # tmux configuration ├── .config/ │ ├── aerospace/ # Window manager config │ ├── ghostty/ # Terminal config │ ├── mise/ # Version manager (Ruby, Node, Elixir, etc.) │ ├── nvim/ # Neovim config (AstroNvim) │ ├── zed/ # Zed editor config │ │ ├── settings.json # Language, LSP, formatter, extension settings │ │ ├── tasks.json # RSpec, Rails, Elixir, Zig, npm tasks │ │ └── snippets/ # ruby.json, erb.json, zig.json │ ├── zellij/ # Zellij config, theme, layouts │ ├── lazygit/ # Lazygit config + theme │ ├── borders/ # JankyBorders window highlighting │ ├── sketchybar/ # Menu bar config + plugins │ └── starship.toml # Prompt configuration ├── themes/ # Theme assets (each has a theme.conf registry) │ ├── tokyo-night/ # Tokyo Night configs per app │ ├── aura/ # Aura Dark configs per app │ └── catppuccin/ # Catppuccin Mocha configs per app ├── bin/ # CLI commands (all available globally via ~/bin) │ ├── dotfiles # Main CLI dispatcher │ ├── dotfiles-update # Upgrade system & sync repo │ ├── dotfiles-sync # Quick refresh: pull, relink, reapply theme │ ├── dotfiles-health # Verify all tools are installed │ ├── dotfiles-theme # Switch theme │ ├── dotfiles-install # Run full installer │ ├── dotfiles-uninstall # Remove all dotfiles symlinks │ ├── dotfiles-backup # Snapshot/restore dotfiles state │ ├── dotfiles-doctor # Auto-fix common issues + SSH key audit │ ├── dotfiles-profile # Measure shell startup time │ ├── dotfiles-export # Export setup as portable snapshot │ ├── dotfiles-add-theme # Scaffold new theme directory │ ├── dotfiles-cleanup # Remove unlisted Homebrew packages │ ├── work-setup # Configure work identity │ ├── work-nuke # Remove all work config │ ├── work-switch # Change employer │ ├── work-status # Show current work setup │ ├── repos-clone # Clone repos from GitHub/GitLab/Bitbucket/Codeberg │ ├── erb-lint-formatter # ERB lint wrapper for Zed │ └── _work-helpers # Shared utilities for work scripts ├── Brewfile.backup # Previous Brewfile (one backup, for rollback) ├── scripts/ │ ├── _helpers.sh # Shared colors & print functions │ ├── setup-git.sh # Git identity & defaults setup │ ├── setup-ssh.sh # SSH key & config setup │ ├── health-check.sh # Verify installation │ ├── theme-utils.sh # Theme utility functions │ └── apply-theme.sh # Apply theme across all apps ├── tests/ # 300 tests across 11 suites, run via GitHub Actions CI │ ├── test-idempotency.sh # Idempotency tests (sandboxed) │ ├── test-work-nuke.sh # Work-nuke edge case tests │ ├── test-repos-clone.sh # Repos-clone logic tests │ ├── test-ssh-adversarial.sh # SSH adversarial input tests │ ├── test-update.sh # Update symlink tests │ ├── test-theme.sh # Theme system tests (apply, rollback, scaffold) │ ├── test-doctor.sh # Doctor auto-fix tests │ ├── test-setup-git.sh # Git identity setup tests │ ├── test-work-status.sh # Work status diagnostic tests │ ├── test-backup.sh # Backup/restore cycle tests │ └── test-sync.sh # Sync symlink refresh tests ├── .github/workflows/test.yml # CI: shellcheck + all test suites └── docs/ # Additional documentation 

All commands work from anywhere — no need to cd ~/dotfiles first.

dotfiles update # Upgrade system & sync repo (pull → brew upgrade → snapshot → push) dotfiles sync # Quick refresh: pull, relink, reapply theme (no upgrades) dotfiles health # Verify all tools are installed and configured dotfiles theme aura # Switch theme (tokyo-night | aura | catppuccin) dotfiles add-theme x # Scaffold a new theme directory with all required files dotfiles cleanup # Find/remove Homebrew packages not in Brewfile (--force) dotfiles doctor # Auto-fix common issues (symlinks, permissions, SSH keys) dotfiles backup # Snapshot dotfiles state (--list, --restore <name>) dotfiles profile # Measure shell startup time (--detailed for per-component) dotfiles export # Export setup snapshot (--json for machine-readable) dotfiles install # Re-run full installer (idempotent) dotfiles edit # Open dotfiles in your editor dotfiles dir # Print dotfiles directory path

All commands support tab-completion. Shorthand also works: dotfiles-update, dotfiles-sync, etc.

1. Pull latest changes from git
2. brew update + brew upgrade + brew cleanup
3. Snapshot Brewfile (captures any new apps you installed manually)
4. Refresh all symlinks
5. Upgrade mise tools
6. Update tmux plugins
7. Reload live configs (tmux, aerospace)
8. Commit & push changes back to repo

Your Brewfile stays in sync automatically. Install apps with brew install or mas install anytime — the next dotfiles update captures them into the repo. One Brewfile.backup is kept for rollback.

dotfiles health

Verifies: core tools, config symlinks, language runtimes, running services (PostgreSQL, MySQL, Redis), shell integrations, and work identity.

The install script is truly idempotent — run it any number of times with identical results:

dotfiles install # Non-interactive, skips what's done dotfiles install --interactive # Prompt for every choice dotfiles install --force # Force reinstall everything

Switch between Tokyo Night, Aura Dark, and Catppuccin Mocha from anywhere:

dotfiles theme tokyo-night # Switch to Tokyo Night dotfiles theme aura # Switch to Aura Dark dotfiles theme catppuccin # Switch to Catppuccin Mocha

This updates 17 apps automatically (Neovim, Ghostty, tmux, Zellij, Starship, Zed, VS Code, Warp, bat, git-delta, fzf, lazygit, borders, sketchybar, yazi, gitui, lsd), then prints instructions for Slack, browsers, Telegram, and Raycast. If the apply fails partway through, all configs are automatically rolled back.

Adding a new theme is just creating a themes/<name>/ directory with a theme.conf — themes are auto-discovered, no code changes needed. Use dotfiles add-theme <name> to scaffold the full directory structure.

Edit Brewfile and run:

brew bundle install

• Settings: .config/zed/settings.json (languages, LSP, formatters)
• Tasks: .config/zed/tasks.json (RSpec, Rails, Zig, etc.)
• Snippets: .config/zed/snippets/ (ruby.json, erb.json, zig.json)

• Aerospace: .config/aerospace/aerospace.toml
• tmux: .tmux.conf
• Neovim: .config/nvim/lua/plugins/*.lua

During install, you can choose 1Password SSH Agent for SSH key management. This gives you:

• Touch ID for git push — each new terminal session requires biometric approval before SSH operations
• No key files on disk — keys live in your 1Password vault, encrypted and synced
• Works everywhere — GitHub, GitLab, Bitbucket, Codeberg, self-hosted Git

How it works:

1. Install sets up ~/.ssh/config to use the 1Password agent socket
2. When you git push in a new terminal session, 1Password prompts for Touch ID
3. Approval lasts until 1Password locks (configurable timeout)

Recommended 1Password settings for maximum security:

Note: This is per-session, not per-push. Once you approve in a terminal tab, subsequent pushes in that tab go through until 1Password locks. For additional protection, consider a short auto-lock timeout.

See QUICK_REFERENCE.md for SSH troubleshooting and testing commands.

# Apple Silicon eval "$(/opt/homebrew/bin/brew shellenv)" # Intel eval "$(/usr/local/bin/brew shellenv)"

# Remove and reinstall rm -rf ~/.tmux/plugins git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm tmux # Press: Ctrl+A then Shift+I

# Clear cache and reinstall rm -rf ~/.local/share/nvim rm -rf ~/.cache/nvim nvim # Will reinstall everything

# Reload configuration aerospace reload # Or restart killall Aerospace open -a Aerospace

Detailed guides for each tool:

• What Gets Installed - Full breakdown of every tool and config change
• Quick Reference - Print this!
• Neovim Guide
• Daily Workflows

300 automated tests across 11 suites run on every push and PR via GitHub Actions:

• Shellcheck — lints all shell scripts (auto-discovers via glob patterns)
• Idempotency — verifies install/setup can run multiple times safely (84 assertions)
• Work identity — tests setup, nuke, switch lifecycle, and status diagnostics
• SSH config — adversarial inputs and edge cases
• Repo cloner — SSH alias detection and URL rewriting
• Update flow — symlink creation and refresh
• Theme system — apply, rollback, idempotency, scaffolding (39 assertions)
• Doctor — auto-fix symlinks, permissions, dry-run mode
• Git setup — identity configuration, work/personal split, smart defaults
• Backup — create, list, restore, prune cycle
• Sync — symlink refresh, broken link repair, dry-run mode

Run locally: bash tests/test-idempotency.sh (or any test file in tests/)

• DHH - Omakub philosophy, Rails workflows, clean configurations
• Omakub - "Everything in one place" installation concept
• ThePrimeagen - Harpoon workflow, tmux setup, vim-first development
• José Valim - Elixir tooling and workflows

• AstroNvim - Neovim distribution
• Tokyo Night - Dark blue theme by folke
• Aura Theme - Deep purple theme by daltonmenezes
• Starship - Fast prompt
• Aerospace - Window manager
• Ghostty - Modern terminal

MIT License - Feel free to use and modify!

Found a bug or have a suggestion? Open an issue or PR!

Made with ❤️ by AJ

If this setup saves you time, consider buying me a coffee:

Inspired by DHH's Omakub and ThePrimeagen's workflows

Last updated: 2026-03-14