Back to Notes

Terminal Perfection: My Complete Zsh + Modern CLI Setup

A curated terminal setup built on Oh My Zsh with modern CLI tools, AI integration, and performance-first philosophy for maximum developer productivity.

After years of terminal optimization, I've crafted a terminal setup that maximizes both productivity and visual appeal. While iTerm2 provides the foundation, the real magic happens in the shell configuration.

My Complete Terminal Stack

Core Foundation: Oh My Zsh + Essential Plugins

My terminal setup is built on Oh My Zsh with a carefully curated set of plugins that enhance productivity without sacrificing performance:

[CODEBLOCK:bash]# ~/.zshrc - The heart of my terminal configuration export ZSH="$HOME/.oh-my-zsh" ZSH_THEME="robbyrussell" # Essential plugins for developer productivity plugins=(git eza zsh-autosuggestions zsh-syntax-highlighting) # Auto-update configuration zstyle ':omz:update' mode auto [/CODEBLOCK]

Modern Command Line Tools

I've replaced traditional Unix tools with modern, feature-rich alternatives:

[CODEBLOCK:bash]# Modern replacements for classic commands alias cat="bat" # Syntax highlighting for file viewing alias ls='eza -a' # Modern ls with better formatting alias la='eza -la' # Long format with hidden files alias ll='eza -ll' # Long format detailed view # System maintenance made simple alias update="brew update && brew upgrade" [/CODEBLOCK]

Enhanced Autosuggestions

Configured for optimal visibility and usability:

[CODEBLOCK:bash]# zsh-autosuggestions styling ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE="fg=#777777" [/CODEBLOCK]

Plugin Deep Dive

1. Git Integration

The git plugin provides essential shortcuts for daily development:

  • gst → git status
  • gco → git checkout
  • gaa → git add --all
  • gcmsg → git commit -m

2. Eza - Modern File Listing

Replaces ls with a more powerful, colorful alternative:

[CODEBLOCK:bash]# Eza provides: # - Git integration (shows file status) # - Better color coding # - Tree view capabilities # - Human-readable file sizes eza -la --git # Shows git status alongside file info [/CODEBLOCK]

3. Zsh Autosuggestions

Intelligent command completion based on history:

  • Suggests commands as you type
  • Accept with right arrow or Ctrl+E
  • Learns from your command patterns

4. Zsh Syntax Highlighting

Real-time syntax validation:

  • Valid commands appear in green
  • Invalid commands show in red
  • Helps catch typos before execution

Development Environment Integration

Windsurf Integration

Seamless integration with the Windsurf AI coding environment:

[CODEBLOCK:bash]# Windsurf CLI access export PATH="/Users/henry/.codeium/windsurf/bin:$PATH" [/CODEBLOCK]

Claude CLI Access

Direct terminal access to Claude AI:

[CODEBLOCK:bash]alias claude="/Users/henry/.claude/local/claude" [/CODEBLOCK]

Performance Optimizations

Startup Speed

My plugin selection prioritizes performance:

  • Minimal plugin count: Only 4 essential plugins
  • Lazy loading: Oh My Zsh handles plugin loading efficiently
  • Auto-updates: Keeps everything current without manual intervention

Memory Efficiency

  • Robbyrussell theme: Lightweight, fast-rendering prompt
  • Selective aliases: Only replace commands that provide significant value
  • No heavy frameworks: Stick to Oh My Zsh's proven performance

Productivity Enhancements

File Navigation

[CODEBLOCK:bash]# Enhanced file operations eza -la --git # File listing with git status bat filename.js # Syntax-highlighted file viewing [/CODEBLOCK]

System Maintenance

[CODEBLOCK:bash]# One-command system updates update # Updates Homebrew and all packages [/CODEBLOCK]

Development Workflow

[CODEBLOCK:bash]# Quick access to AI tools claude "explain this code" # Direct Claude integration windsurf . # Open current directory in Windsurf [/CODEBLOCK]

Why This Setup Works

Minimalist Philosophy

Rather than loading dozens of plugins, I focus on four essential ones that provide maximum value:

  1. Git integration - Essential for daily development
  2. Modern file tools - Better UX for common operations
  3. Smart suggestions - Learns from your patterns
  4. Syntax validation - Prevents errors before execution

Performance First

  • Fast startup: ~200ms shell initialization
  • Responsive suggestions: No lag during typing
  • Efficient updates: Automatic maintenance without interruption

AI-Enhanced Workflow

The integration with Windsurf and Claude transforms the terminal from a simple command interface into an AI-augmented development environment:

[CODEBLOCK:bash]# Traditional workflow vim file.js # edit code git add . git commit -m "fix bug" # AI-enhanced workflow windsurf file.js # AI-assisted editing claude "review this commit" # AI code review gaa && gcmsg "$(claude 'generate commit message for these changes')" [/CODEBLOCK]

Installation Guide

Prerequisites

[CODEBLOCK:bash]# Install Oh My Zsh sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" # Install modern tools via Homebrew brew install bat eza [/CODEBLOCK]

Plugin Installation

[CODEBLOCK:bash]# 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 [/CODEBLOCK]

Configuration

Copy the configuration from my .zshrc above, then:

[CODEBLOCK:bash]source ~/.zshrc # Reload configuration [/CODEBLOCK]

The Result

This setup creates a terminal environment that's:

  • Fast: Sub-second startup and response times
  • Intelligent: Learns from your patterns and suggests improvements
  • Modern: Uses contemporary tools with better UX
  • AI-integrated: Seamlessly connects with development AI tools
  • Maintainable: Auto-updates and minimal configuration drift

The terminal becomes less of a tool and more of an intelligent development partner.

A well-configured terminal isn't just about aesthetics—it's about creating an environment where your thoughts flow directly into productive action.