Custom Terminal Setup

This repository documents a macOS terminal customization using zsh, oh-my-zsh, powerlevel10k, and useful shell plugins.

Tested on macOS with Homebrew installed.

What you will get

• oh-my-zsh shell framework
• powerlevel10k prompt theme
• command highlighting with zsh-syntax-highlighting
• shell suggestions with zsh-autosuggestions
• patched developer fonts for icons and glyphs
• optional VS Code terminal font configuration

---

1. Install prerequisites

Install Homebrew (if needed)

If you do not have Homebrew installed, run:

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

Install Hack Nerd Font

brew tap homebrew/cask-fonts
brew install font-hack-nerd-font

Once installed, set your terminal font to Hack Nerd Font in Terminal, iTerm2, or VS Code.

Important: select the font before you run p10k configure, otherwise Powerlevel10k may display missing or incorrect icons.

---

2. Install oh-my-zsh

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

This installs ~/.oh-my-zsh and creates a default ~/.zshrc file.

---

3. Install Powerlevel10k and plugins

Powerlevel10k theme

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

zsh-syntax-highlighting plugin

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

zsh-autosuggestions plugin

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

---

4. Edit your zsh configuration

Open your Zsh config file:

open ~/.zshrc

Then update the theme and plugin list:

ZSH_THEME="powerlevel10k/powerlevel10k"

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

If you already have other plugins enabled, keep them in the list. zsh-syntax-highlighting should be last so it loads after the other plugins.

Save the file and reload your shell:

source ~/.zshrc

---

5. Configure Powerlevel10k

Run the Powerlevel10k configuration wizard:

p10k configure

Tip: make sure your terminal is already using Hack Nerd Font before running this command so the prompt icons appear correctly.

If you prefer manual editing, open the config file:

open ~/.p10k.zsh

---

6. Update installed plugins

Keep the theme and plugins current with this command:

git -C ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k pull && \
git -C ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting pull && \
git -C ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-autosuggestions pull

---

7. Optional: VS Code terminal font

If you use the integrated VS Code terminal, add this to your settings:

{
  "terminal.integrated.fontFamily": "Hack Nerd Font"
}

Have fun

Enjoy your customized terminal setup