noshdocs

Getting Started

Learn how to use nosh

Welcome to nosh

nosh is a modern shell that's fully compatible with Bash and POSIX, featuring a powerful plugin system, customizable prompts, and AI-powered command generation.

Why nosh?

  • 90x FasterInstant prompts, no more waiting
  • Bash Compatible — Run all your existing scripts and commands
  • Plugin System — Extend functionality with TOML-based plugins
  • Smart Prompts — Starship-like prompts with git status, language versions, and more
  • AI Assistant — Translate plain English to shell commands
  • Free Tier — 5,000 tokens/month included, no credit card required

Quick Start

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

# Start using it
nosh

That's it. nosh works out of the box as a powerful shell with smart prompts and context detection.

Features at a Glance

Smart Prompts

nosh automatically detects your project context and shows relevant information:

user@dev ~/projects/myapp (main *) [rust 1.75] [node 20.10]

Plugin System

Extend nosh with simple TOML plugins:

[plugin]
name = "git"
description = "Git integration"

[provides.branch]
command = "git branch --show-current"

AI Mode

When you need help with a command, just ask:

 ?find large files eating my disk space
 find . -type f -size +100M -exec ls -lh {} \;

Two modes available:

  • Simple (?) — Quick translations, included in free tier
  • Agentic (??) — AI investigates by running commands, requires subscription

Next Steps