HyperZsh

A blazing-fast, developer-centric terminal with Oh My Zsh, Powerlevel10k, Nerd Font, fzf, and the best Zsh plugins—fully compatible across macOS, Ubuntu/Debian, Arch/Manjaro, and WSL2.

GitHub: git@github.com:barunTayenjam/hyperzsh.git
Author: barunTayenjam

Features

• Powerlevel10k: Ultra-fast, beautiful, and customizable prompt.
• Developer-AI Productivity: Contextual autocompletion for Git, modern CLI tools, and rich plugin support.
• Plugins: git, autosuggestions, syntax highlighting, fzf, direnv, and AI-powered autocomplete.
• Lightning-fast fuzzy search and context-aware autocompletion.
• Cross-platform: Clean, tested, and error-free setup on macOS, Linux, WSL2—single config, works everywhere.

Installation

1. Install Zsh and Git

macOS:

brew install zsh git

Ubuntu/Debian/WSL2:

sudo apt update
sudo apt install zsh git

Arch/Manjaro:

sudo pacman -Syu zsh git

2. Install Oh My Zsh

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

3. Install Powerlevel10k

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

4. Install Plugins

See Plugin Setup, Troubleshooting & Advanced Notes for details and troubleshooting.

• zsh-autosuggestions

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

• zsh-syntax-highlighting

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

• zsh-interactive-cd

  git clone https://github.com/changyuheng/zsh-interactive-cd.git \
    ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-interactive-cd

• zsh-autocomplete

  git clone --depth 1 https://github.com/marlonrichert/zsh-autocomplete.git \
    ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autocomplete

5. Install Modern CLI Tools

macOS (Homebrew):

brew install fzf direnv eza bat dust duf btm fd neovim neofetch

Ubuntu/Debian/WSL2:

sudo apt install fzf direnv exa bat fd-find duf btop neovim neofetch
# Optional: Install 'eza', 'dust' via cargo (Rust) if not in repo

Arch/Manjaro:

sudo pacman -S fzf direnv eza bat dust duf bottom fd neovim neofetch

6. Install Nerd Font (MesloLGS)

macOS (Homebrew):

brew tap homebrew/cask-fonts
brew install --cask font-meslo-lg-nerd-font

Set "MesloLGS NF" as your terminal font in Preferences.

Linux/WSL2:

• Download from Nerd Fonts
• Unzip and copy .ttf files to ~/.local/share/fonts/
• Run fc-cache -fv
• Set terminal font to "MesloLGS NF" in terminal emulator preferences.

Arch Linux:

sudo pacman -S nerd-fonts-meslo

Or use your AUR helper.

Windows (WSL2):

• Download the zip from Nerd Fonts
• Install all .ttf files.
• Set your Windows Terminal Profile to "MesloLGS NF".

7. Configure your Terminal

• Copy .zshrc from this repo to your $HOME directory.
• Optionally copy .p10k.zsh.example to ~/.p10k.zsh, and run p10k configure.

---

📥 How to Replace Your .zshrc With the Version From This Repo (e.g., on a Server/WSL)

SSH into your remote machine (skip this step if you’re working locally):

ssh youruser@your-remote-server

Back up your existing .zshrc:

cp ~/.zshrc ~/.zshrc.backup.$(date +'%Y%m%d%H%M%S')

Download the new .zshrc from GitHub:

curl -o ~/.zshrc https://raw.githubusercontent.com/barunTayenjam/hyperzsh/main/.zshrc

Tip: To use wget instead, try

wget -O ~/.zshrc https://raw.githubusercontent.com/barunTayenjam/hyperzsh/main/.zshrc

Verify the update:

head -20 ~/.zshrc

Apply changes (reload config immediately):

source ~/.zshrc

To restore your previous settings: If needed, simply run

cp ~/.zshrc.backup.YYYYMMDDHHMMSS ~/.zshrc
source ~/.zshrc

(change the timestamp as appropriate).

---

Source your shell:

source ~/.zshrc

Optionally, run Powerlevel10k's setup wizard:

p10k configure

Tips & Troubleshooting

• Update plugins: Pull new commits from plugin repositories regularly.
• For unknown commands/tools: Install with your package manager or from the official repo.
• WSL users: All *nix instructions apply; set fonts via Windows Terminal settings.

See Plugin Setup, Troubleshooting & Advanced Notes for plugin-specific help.

License

MIT.

Credit: Community plugin developers and Powerlevel10k contributors.