nVs Terminal Setup

One-command terminal setup for macOS developers. Installs and configures iTerm2, Powerlevel10k, modern CLI tools, and a Catppuccin Mocha dark theme.

What's Included

File	Description
nvs-terminal-setup.sh	Automated setup script — run this to install everything
terminal-setup-guide.md	Step-by-step guide (for manual setup or AI agent instructions)
iterm2-cheatsheet.md	Full markdown reference for all shortcuts and tools
iterm2-cheatsheet.pdf	Printable 4-page cheat sheet (Catppuccin dark theme)
generate_cheatsheet_pdf.py	Python script to regenerate the PDF (requires reportlab)

Quick Start

# Clone and run
git clone <repo-url> && cd nvs-terminal-setup
bash nvs-terminal-setup.sh

The script is idempotent — safe to run multiple times. It checks what's already installed and skips it.

What Gets Installed

• iTerm2 — Terminal emulator
• Powerlevel10k — Zsh prompt with git status, language versions
• Catppuccin Mocha — Dark color scheme
• MesloLGS Nerd Font — Monospace font with icons
• fzf — Fuzzy finder (Ctrl+R history, Ctrl+T files)
• fzf-tab — Fuzzy tab completion with previews
• bat — cat with syntax highlighting
• eza — ls with icons, colors, git status
• fd — Fast find replacement
• zoxide — Smart cd that learns your directories
• fast-syntax-highlighting — Real-time command validation
• zsh-autosuggestions — Ghost-text suggestions from history

Post-Setup (Manual)

1. Open iTerm2 — Powerlevel10k wizard launches automatically
2. Go to Preferences > Profiles > Keys > Presets > Natural Text Editing

AI Agent Setup

Give terminal-setup-guide.md to Claude Code or any AI agent with:

"Follow this guide to set up my terminal."

The guide includes agent-specific instructions, verification checklist, and troubleshooting.

Cheat Sheet

Print iterm2-cheatsheet.pdf (4 pages) and pin it at your workspace:

• Page 1: iTerm2 shortcuts, Copy Mode, CLI tools
• Page 2: Git aliases, tmux, workflows
• Page 3: Practice drills, quick reference cards
• Page 4: Copy Mode deep dive (mouseless text selection)

Prerequisites

• macOS (Apple Silicon or Intel)
• Homebrew
• Zsh (default since macOS Catalina)