Skip to content

About

A comprehensive setup combining Neovim with AI capabilities and macOS system configuration

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

1 watching

Forks

Repository files navigation

macOS + Neovim Development Environment

The Mac setup we use at Forward Email to write all our code: our Neovim config, our Homebrew package list and our favorite apps.

Neovim with this configuration

Contents

What you get

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.

Our favorite apps

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.

Install

Run each step in Terminal, in order. Total time is about an hour, most of it downloads.

1. Install Homebrew

/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 --version

2. Download this repo

Back 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/nvim

3. Install the packages and apps

brew bundle --file=~/.config/nvim/macos-setup/Brewfile

This takes 20 to 30 minutes. To install less, open the Brewfile first and delete the lines you do not want.

4. Set up the shell

~/.config/nvim/macos-setup/setup-fzf.sh
echo "source $(brew --prefix)/share/powerlevel10k/powerlevel10k.zsh-theme" >> ~/.zshrc

Quit and reopen your terminal. Powerlevel10k starts its setup wizard. Run p10k configure to start it again later.

5. Open Neovim

nvim

Plugins install on the first launch. Wait for them to finish, quit with :qa, then open Neovim again.

6. Download the AI model (optional)

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

7. Check your setup

~/.config/nvim/verify-installation.sh

The script prints a fix next to anything that fails.

8. Secure your Mac

Follow the macOS setup guide to turn on FileVault and the firewall, change DNS and apply the Finder and Dock settings.

Find what you need

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"

Cheat sheet

Neovim

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.

Terminal

Keys Action
Ctrl+R Search command history
Ctrl+T Search files and paste the path
Option+C Search folders and cd into one

Keep it updated

# 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_M

Update Neovim plugins from inside Neovim with :Lazy update.

Uninstall

rm -rf ~/.config/nvim ~/.local/share/nvim ~/.local/state/nvim
[ -d ~/.config/nvim.backup ] && mv ~/.config/nvim.backup ~/.config/nvim

This removes the Neovim config and restores your backup. Packages installed by Homebrew stay. Remove any of them with brew uninstall <name>.

Contributing

Open an issue or pull request. See CONTRIBUTING.md.

License

MIT © Forward Email

About

A comprehensive setup combining Neovim with AI capabilities and macOS system configuration

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages