Where to Find Nushell Documentation and Learning Resources

Updated

The official Nushell documentation lives at nushell.sh, and it is organized into five distinct tracks: Getting Started, Coming to Nu, Nu Fundamentals, Programming in Nu, and Nu as a Shell. Which one you open first depends on whether you are new to shells in general, migrating from Bash or PowerShell, or planning to write Nu scripts. The site also links a Discord community for questions and accepts feedback or pull requests for improvements.

Start here: Getting Started

The Getting Started guide walks you through becoming familiar with Nushell's basic usage. This is the right entry point if you have installed Nu and want to run your first pipelines. Per the site, after installing you launch Nu by typing nu, and the Getting Started guide takes over from there.

If you already know another shell or language

Coming to Nu describes the similarities and differences between Nushell and other languages and shells. Read this if you are coming from Bash, Zsh, or PowerShell and want to know what carries over and what does not.

For systematic, deeper coverage

Two tracks go beyond the basics:

  • Nu Fundamentals — a more elaborate and structured description of the fundamentals.
  • Programming in Nu — describes Nu as a programming language, for when you want to write scripts rather than run one-off commands.

For interactive use and configuration

Nu as a Shell gives you insight into interactive functionality and configurability in a shell environment. Use this when your questions are about the shell experience itself rather than the language.

Choosing a track

Your situation Start with
Never used Nu, want first commands Getting Started
Coming from Bash/Zsh/PowerShell Coming to Nu
Want structured fundamentals Nu Fundamentals
Writing scripts in Nu Programming in Nu
Configuring interactive shell behavior Nu as a Shell

Installation resources

The site states Nushell is available as downloadable binaries, via your favourite package manager, in a GitHub Action, and as source code. Detailed installation instructions are linked from the site. Documented examples include:

macOS / Linux:

brew install nushell
nix profile install nixpkgs#nushell

Windows:

winget install nushell
winget install nushell --scope machine

The first winget command installs to user scope by default; the second performs a machine-scope installation and must be run as admin. After installing, launch Nu by typing nu.

Community and feedback

The site points to a Discord server for questions about Nu. It also notes you can help improve the site by giving feedback or sending a PR.