Skip to content

forwardemail/macos-nvim-development-environment

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

16 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Complete macOS Development Environment

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

This package provides everything you need for a modern, productive, and secure macOS development environment.

Screenshot

πŸ“¦ What's Included

1. Neovim Configuration

  • AI-powered coding with Avante + local Ollama
  • Full LSP support for multiple languages
  • Modern plugins: Telescope, Neo-tree, Treesitter, Git integration
  • Voice control with Handy integration (optional)

2. macOS System Setup

  • Brewfile with 90+ CLI tools and 40+ GUI applications (including ansible)
  • Security hardening: FileVault, Firewall, telemetry blocking
  • Privacy enhancements: Cloudflare DNS, tracking prevention
  • Shell setup: zsh, Powerlevel10k, fzf with Ctrl+R
  • System tweaks: Finder, Dock, keyboard shortcuts

πŸš€ Quick Start

1. Install System Packages

# Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install all packages from Brewfile
cd macos-setup
brew bundle --file=Brewfile

2. Install Neovim Configuration

# Backup existing config
mv ~/.config/nvim ~/.config/nvim.backup

# Copy new config
cp -r . ~/.config/nvim/

3. Start Ollama

ollama serve

# In another terminal
ollama pull qwen2.5-coder:7b-instruct-q4_K_M

4. Test

nvim
# Press ,aa to open Avante
# Ask coding questions, get refactoring help, generate code

πŸ“ Documentation

Neovim

macOS Setup

πŸ“š Complete Documentation Index

Installation & Setup

Neovim Features

AI & Automation

macOS Configuration

Troubleshooting

Terminal & Theme

Development

⌨️ Key Bindings Quick Reference

Neovim (Leader: ,)

  • ,aa - Open Avante (AI assistant)
  • ,e - Toggle file tree
  • ,ff - Find files
  • ,fg - Search in files
  • ,gg - Open LazyGit
  • gA - Format code

Shell (with fzf)

  • Ctrl+R - Fuzzy search command history
  • Ctrl+T - Fuzzy search files
  • Alt+C - Fuzzy search directories

πŸ” Security Features

  • βœ… FileVault encryption enabled
  • βœ… Firewall with blocked incoming connections
  • βœ… Apple telemetry blocked
  • βœ… Privacy-focused DNS (Cloudflare)
  • βœ… Local AI (no cloud services)
  • βœ… Gatekeeper kept enabled

🎯 Installation Checklist

macOS System (30-60 min)

  • Install Homebrew
  • Run brew bundle from macos-setup/
  • Run ./setup-fzf.sh
  • Configure Powerlevel10k (p10k configure)
  • Enable FileVault
  • Enable Firewall
  • Block Apple telemetry
  • Apply Finder/Dock tweaks

Neovim (15-30 min)

  • Copy config to ~/.config/nvim/
  • Run ./verify-installation.sh
  • Start Ollama: ollama serve
  • Pull model: ollama pull qwen2.5-coder:7b-instruct-q4_K_M
  • Test Neovim: nvim
  • Test Avante: ,aa

πŸ”„ Maintenance

# Update Homebrew packages
brew update && brew upgrade && brew cleanup

# Update Neovim plugins
nvim
:Lazy update

# Update Ollama
brew upgrade ollama
ollama pull qwen2.5-coder:7b-instruct-q4_K_M

πŸ“– Additional Resources

🀝 Contributing

Suggestions and improvements welcome! This is a living configuration.

πŸ“„ License

MIT License - See LICENSE.md


Quick Links:

About

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

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors