Skip to content

forwardemail/macos-nvim-development-environment

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

15 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

No packages published

Contributors 2

  •  
  •