nlsh - Natural Language Shell

Talk to your terminal in plain English.

Requirements: macOS or Linux (Windows not currently supported), Ollama running locally

Install

curl -fsSL https://raw.githubusercontent.com/varunrandery/nlsh/main/install.sh | bash

Uninstall

curl -fsSL https://raw.githubusercontent.com/varunrandery/nlsh/main/uninstall.sh | bash

Or from within nlsh: !uninstall

Usage

nlsh

Type naturally:

• list all python files → find . -name "*.py"
• git commit with message fixed bug → git commit -m "fixed bug"

Commands:

• !help - Show help
• !model [name] - Show or change the Ollama model
• !cmd - Run cmd directly
• ?prompt - Force LLM translation (bypass shell detection)
• !uninstall - Remove nlsh
• ctrl+D - Exit

Local Development

Prerequisites

1. Ollama installed and running

2. Default model pulled

   ollama pull gemma3:12b-it-qat

3. uv package manager

Setup

# Clone the repository
git clone https://github.com/varunrandery/nlsh.git
cd nlsh

# Install dependencies and create virtual environment
uv sync

# Run the application
uv run python nlsh