Prophet's Guide to Nushell

Learn Nushell and set up Prophet's environment (WezTerm, Zellij, Helix, Claude Code)

About These Manuals

The best place to start learning Nushell is the official Nushell Book—it's exceptionally well-written, actively maintained, and always up to date.

These manuals serve a different purpose. Unlike the comprehensive Nushell Book, we focus on practical, platform-specific guidance (currently macOS). We start with installation and setup, then progress to tuning Nushell, demonstrating its use for real work tasks, and showcasing other handy CLI and TUI tools. Each manual includes accompanying video guides and provides detailed, step-by-step instructions for newcomers ("nu-bies") who may find certain setup tasks intimidating.

While many configuration steps seem obvious to experienced developers, they can be confusing for beginners. That's why we walk you through each step clearly, providing battle-tested, efficient defaults—though opinionated—so you can get Nushell properly set up and start learning through hands-on experimentation.

Manuals

1. Install Nushell on macOS Tahoe from scratch

   • Install VS Code
   • Install Homebrew
   • Install Nushell
   • Prepare to Use XDG_CONFIG_HOME
   • Configure XDG_CONFIG_HOME
   • Initialize Git Repository
   • Basic Settings

2. Install Claude Code on macOS (Optional)

   • Installing Node.js
   • Installing Claude Code
   • Verifying installation with /doctor
   • Installing VS Code extension

3. macOS Tweaks for Terminal Users

   • Terminal Settings
   • macOS Settings Through Terminal
   • Finder Settings

4. Installing WezTerm Terminal on macOS

   • Installing WezTerm
   • Configuring WezTerm to Launch Nushell by Default
   • Setting the $env.PATH Variable

5. Setting Up Quick Select Patterns in WezTerm

   • What Are Quick Select Patterns?
   • Configuring Quick Select Patterns
   • Using Quick Select