The Mac setup we use at Forward Email to write all our code: our Neovim config, our Homebrew package list and our favorite apps.
- What you get
- Our favorite apps
- Install
- Find what you need
- Cheat sheet
- Keep it updated
- Uninstall
- Contributing
- License
| Part | What it is | Where it lives |
|---|---|---|
| Neovim config | LSP, linting, formatting, fuzzy search, file tree, git and local AI chat | init.lua, lua/ |
| Brewfile | 65 command-line tools, 28 apps and 6 Nerd Fonts in one command | macos-setup/Brewfile |
| macOS guide | FileVault, firewall, DNS, shell, Finder and Dock settings | macos-setup/README.md |
| Guides | One page per topic | docs/ |
The AI features run on your Mac through Ollama. No code leaves your machine.
| App | What we use it for | Install |
|---|---|---|
| Neovim | Editor for all our code | brew install neovim |
| Powerlevel10k | Fast zsh prompt with git status | brew install powerlevel10k |
| SquirrelDisk | Find what fills up the disk | Download |
| UTM | Linux and Windows virtual machines | brew install --cask utm |
| CrystalFetch | Windows 11 installer ISOs for UTM | brew install --cask crystalfetch |
| Mullvad VPN | VPN that needs no email to sign up | brew install --cask mullvad-vpn |
| LuLu | Firewall that blocks unknown outgoing connections | brew install --cask lulu |
| Hot | Menu bar CPU temperature and thermal throttling | brew install --cask hot |
| UNetbootin | Bootable Linux USB drives | Download |
Step 3 below installs all of these except SquirrelDisk and UNetbootin. Download those two from the links in the table.
Run each step in Terminal, in order. Total time is about an hour, most of it downloads.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"When it finishes, Homebrew prints two commands under "Next steps". Run them, then check that it works:
brew --versionBack up any existing Neovim config, then clone this repo into its place:
[ -d ~/.config/nvim ] && mv ~/.config/nvim ~/.config/nvim.backup
git clone https://github.com/forwardemail/macos-nvim-development-environment ~/.config/nvimbrew bundle --file=~/.config/nvim/macos-setup/BrewfileThis takes 20 to 30 minutes. To install less, open the Brewfile first and delete the lines you do not want.
~/.config/nvim/macos-setup/setup-fzf.sh
echo "source $(brew --prefix)/share/powerlevel10k/powerlevel10k.zsh-theme" >> ~/.zshrcQuit and reopen your terminal. Powerlevel10k starts its setup wizard. Run p10k configure to start it again later.
nvimPlugins install on the first launch. Wait for them to finish, quit with :qa, then open Neovim again.
Skip this step if you do not want the AI chat. The download is about 5 GB.
brew services start ollama
ollama pull qwen2.5-coder:7b-instruct-q4_K_M~/.config/nvim/verify-installation.shThe script prints a fix next to anything that fails.
Follow the macOS setup guide to turn on FileVault and the firewall, change DNS and apply the Finder and Dock settings.
| I want to... | Read |
|---|---|
| Fix something that is broken | Troubleshooting |
| Look up a key binding | Key bindings |
| See what a plugin does | Plugins |
| Learn how the Neovim config works | Neovim overview |
| Fix missing icons or question marks | Nerd Fonts, Terminal setup |
| Remove underlines from URLs in the terminal | Terminal URL underlines |
| Understand errors, warnings and code actions | LSP diagnostics |
| Set up XO, Prettier, remark or stylelint | Linter config files |
| Set up or change the local AI | Ollama setup, Ollama models |
| Talk to the AI with your voice | Voice control |
| Change the colors | IR Black theme |
| Harden macOS, set up zsh and fzf | macOS setup guide |
| See every package we install | Brewfile |
| Move from Vim to Neovim | Migration |
To search every guide at once, press / on this page on GitHub and type a word. From a clone:
rg -i "clipboard" ~/.config/nvim --glob "*.md"The leader key is , (comma). For example, ,ff means press comma, then f twice.
| Keys | Action |
|---|---|
,n |
Toggle the file tree |
,ff |
Find a file by name |
,fg |
Search text in all files |
,fb |
Switch between open files |
gd |
Go to definition |
K |
Show docs for the word under the cursor |
gA |
Format the file |
,e |
List errors in the file |
,gg |
Open LazyGit |
,aa |
Open the AI chat |
,w |
Save |
,c |
Copy the selection to the system clipboard |
,v |
Paste from the system clipboard |
The config formats code when you press gA. It does not format on save. See all key bindings.
| Keys | Action |
|---|---|
Ctrl+R |
Search command history |
Ctrl+T |
Search files and paste the path |
Option+C |
Search folders and cd into one |
# This repo
git -C ~/.config/nvim pull
# Homebrew packages and apps
brew update && brew upgrade && brew cleanup
# AI model
ollama pull qwen2.5-coder:7b-instruct-q4_K_MUpdate Neovim plugins from inside Neovim with :Lazy update.
rm -rf ~/.config/nvim ~/.local/share/nvim ~/.local/state/nvim
[ -d ~/.config/nvim.backup ] && mv ~/.config/nvim.backup ~/.config/nvimThis removes the Neovim config and restores your backup. Packages installed by Homebrew stay. Remove any of them with brew uninstall <name>.
Open an issue or pull request. See CONTRIBUTING.md.
