Installation

nosh is written in Rust and available via one-line install, Cargo, or pre-built binaries.

Quick Install (Recommended)

The easiest way to install nosh:

curl -fsSL https://noshell.dev/install.sh | sh

This automatically detects your OS and architecture, downloads the right binary, and installs it to ~/.local/bin.

Options:

NOSH_INSTALL_DIR - Override install location (default: ~/.local/bin)

Pre-built Binaries

Download manually if you prefer:

# macOS (Apple Silicon)
curl -fsSL https://github.com/TryNosh/nosh/releases/latest/download/nosh-aarch64-apple-darwin.tar.gz | tar xz
sudo mv nosh /usr/local/bin/

# macOS (Intel)
curl -fsSL https://github.com/TryNosh/nosh/releases/latest/download/nosh-x86_64-apple-darwin.tar.gz | tar xz
sudo mv nosh /usr/local/bin/

# Linux (x86_64)
curl -fsSL https://github.com/TryNosh/nosh/releases/latest/download/nosh-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv nosh /usr/local/bin/

# Linux (ARM64)
curl -fsSL https://github.com/TryNosh/nosh/releases/latest/download/nosh-aarch64-unknown-linux-gnu.tar.gz | tar xz
sudo mv nosh /usr/local/bin/

Verify Installation

nosh --version

Start Using nosh

Just run nosh to start the shell:

nosh

On first run, nosh will:

Set up default configuration
Install built-in plugins
Prompt you to sign up for AI features

Set as Default Shell

To use nosh as your default shell:

# Add nosh to allowed shells
echo $(which nosh) | sudo tee -a /etc/shells

# Set as default
chsh -s $(which nosh)

AI Setup

nosh includes AI features for translating natural language to shell commands.

Free Tier

Get started with 5,000 tokens/month for free:

nosh
# Follow the prompts to enter your email
# Click the magic link in your inbox

Paid Plans

For more tokens and agentic mode (??):

# In nosh
/buy
# Select a plan

See Pricing for subscription options.

Updating

Run the install script again to get the latest version:

curl -fsSL https://noshell.dev/install.sh | sh