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.