iTerm2 Setup Guide

Advanced terminal for macOS

Last updated: May 22, 2026

Why iTerm2?

iTerm2 is a powerful replacement for macOS Terminal. It offers split panes, search, autocomplete, profiles, and extensive customization. Essential for AI developers who live in the terminal.

Step 1: Install iTerm2

  1. 1. Visit iterm2.com
  2. 2. Download the latest version (free)
  3. 3. Drag to Applications folder
  4. 4. Open iTerm2 once to complete installation

Step 2: Install Oh My Zsh

Oh My Zsh gives you themes, plugins, and a better prompt:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

This will:

Step 3: Install Powerlevel10k Theme

A beautiful, fast, and customizable theme:

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

Edit your Zsh config:

nano ~/.zshrc
# Change: ZSH_THEME="robbyrussell"
# To: ZSH_THEME="powerlevel10k/powerlevel10k"

Restart iTerm2 and follow the setup wizard.

Step 4: Essential Plugins

Install these Oh My Zsh plugins:

# Install zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

# Install zsh-syntax-highlighting
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

Add to your ~/.zshrc:

plugins=(git zsh-autosuggestions zsh-syntax-highlighting)

Essential iTerm2 Features

Split Panes

Cmd+D (vertical), Cmd+Shift+D (horizontal)

Find

Cmd+F - Search terminal output

Tabs

Cmd+T (new tab), Cmd+→/← (switch)

Fullscreen

Cmd+Enter - Toggle fullscreen

Paste History

Cmd+Shift+H - See paste history

Instant Replay

Cmd+Shift+B - Replay terminal

Recommended Settings

Open iTerm2 → Preferences:

🔧 Troubleshooting

Powerlevel10k font issues

Install a Nerd Font: brew install --cask font-meslo-lg-nerd-font then select it in iTerm2 preferences.

Oh My Zsh not loading

Make sure ~/.zshrc exists and has the Oh My Zsh initialization line.

Slow startup

Run zsh -x to debug. Remove unused plugins.

🎉 Terminal is Ready!

Your terminal is now optimized for AI development. Next, set up Continue.dev for AI-assisted coding, or explore the AI Toolkit to start building.