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 applied across 21 apps.
These are my personal dotfiles. They're opinionated for how I work — my keybindings, my workspace layout, my editor and model choices. Everything is installable with one command and personalizable via flags, but the honest advice is: fork it, steal the pieces you like, and adapt rather than running it blind. The philosophy comes from DHH's Omakub: everything in one place, everything just works.
| Area | Choices |
|---|---|
| Window manager | Aerospace — i3-style tiling, keyboard-first |
| Terminal | Ghostty (GPU-accelerated), Zellij multiplexer with Rails/Phoenix layouts |
| Editors | Neovim (AstroNvim) + Zed, both with full LSP, format-on-save everywhere |
| Shell | zsh (modular configs) + Starship prompt + fzf-tab, autosuggestions, syntax highlighting |
| Languages | mise-managed: Ruby (pinned), Node, Elixir/Erlang, Python, Go, Rust + Zig via zls |
| Databases | PostgreSQL, MySQL, Redis, SQLite |
| Git | lazygit, GitHub CLI, per-directory work/personal identity, 1Password SSH agent |
| AI tooling | Claude Code, llm + Ollama (local models), Copilot CLI — see docs/AI_TOOLS.md |
| Theme system | Tokyo Night / Aura Dark / Catppuccin Mocha across 21 apps (16 automatic, 5 manual) with rollback on failure |
Fresh-Mac prerequisites (one-time): sign in to your Apple ID and open the App Store once (for the mas-installed apps), and accept the Xcode Command Line Tools dialog when install.sh triggers it.
bash <(curl -fsSL https://raw.githubusercontent.com/AnjanJ/dotfiles/main/install.sh)Or clone first: git clone https://github.com/AnjanJ/dotfiles.git ~/dotfiles && bash ~/dotfiles/install.sh
Fully non-interactive with sensible defaults, and idempotent — run it 10 times, get the same result. Personalize via flags:
bash install.sh --name "AJ" --email "aj@example.com" --theme aura
bash install.sh --interactive # Prompt for every choice
bash install.sh --groups "core,editors" # Install only specific Brewfile groups
bash install.sh --help # All optionsIt installs Homebrew + the Brewfile packages, links every config via the symlink map, applies your theme, sets up git/SSH/macOS defaults, and runs a health check.
dotfiles update # Upgrade everything & sync the repo
dotfiles sync # Quick refresh: pull, relink, reapply theme
dotfiles health # Verify tools, symlinks, runtimes, services
dotfiles doctor # Auto-fix symlinks, permissions, SSH
dotfiles theme aura # Switch theme (tokyo-night | aura | catppuccin)Full CLI reference, Brewfile recovery stories, and troubleshooting: docs/MAINTENANCE.md
| Doc | Contents |
|---|---|
| docs/KEYBINDINGS.md | Aerospace, Neovim, Zellij bindings and layouts |
| docs/THEMES.md | Palettes, switching, adding your own theme |
| docs/AI_TOOLS.md | llm, Ollama, Copilot CLI — the AI-augmented shell |
| docs/SSH.md | 1Password SSH agent: Touch ID for git push, no keys on disk |
| docs/STRUCTURE.md | Repo layout, symlink map, modular shell design |
| docs/MAINTENANCE.md | CLI reference, update flow, recovery, testing, troubleshooting |
| docs/DAILY_WORKFLOWS.md | Day-to-day usage patterns |
| QUICK_REFERENCE.md | Printable cheat sheet |
- One command, idempotent — from zero to productive in minutes; safe to re-run forever
- Single source of truth — every managed symlink is declared once (scripts/symlink-map.sh); install, update, sync, doctor, and health all read the same map, so nothing drifts silently
- Recovery stories everywhere — Brewfile backups, theme rollback on partial failure, git-history restore paths
- Tested like software — 11 CI suites + shellcheck on every push, because 8k lines of shell deserves tests
- Keyboard-first, unified aesthetics — vim motions, tiling windows, one palette across every tool
- DHH / Omakub — the "everything in one place" philosophy
- ThePrimeagen — Harpoon workflow, vim-first development
- José Valim — Elixir tooling and workflows
- AstroNvim, Starship, Aerospace, Ghostty — the tools this is built on
- Themes: Tokyo Night by folke, Aura by daltonmenezes, Catppuccin
MIT — use and modify freely.
If this setup saves you time, consider sponsoring. It keeps development going and lets me know people find it useful.
Made with ❤️ by Anjan