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 Faster — Instant 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
- Install nosh on your machine
- See how nosh compares to zsh
- Configure your shell and prompts
- Learn about plugins
- Set up AI mode
- View pricing