Welcome to Whisp

Whisp is an AI-powered shell assistant that translates natural language into shell commands. Stop memorizing obscure flags and syntax — just describe what you want.

What is Whisp?

Whisp runs as a lightweight daemon that listens for your natural language queries and returns the exact shell command you need. It understands your context (working directory, shell, OS, recent commands) to give you smarter suggestions.

$ , find all python files modified in the last week
➜ find . -name "*.py" -mtime -7

Key Features

• Natural Language Commands — Type what you want in plain English
• Automatic Error Fixing — When commands fail, whisp suggests fixes
• Context Aware — Knows your directory, shell, and command history
• Safe by Default — Destructive commands require confirmation
• Pipe Mode — Summarize or analyze command output with AI

Quick Example

# Start the daemon
$ whisp start

# Ask for a command
$ , compress all log files older than 30 days
➜ find . -name "*.log" -mtime +30 -exec gzip {} \;

# Pipe output for analysis
$ cat error.log | , summarize the errors
➜ The log contains 3 connection timeouts and 2 authentication failures...

# When a command fails, whisp helps
$ gcc main.c -o main
error: undefined reference to 'sqrt'
# whisp suggests:
➜ gcc main.c -o main -lm

Next Steps

Ready to get started? Check out the Installation Guide or jump straight to Quick Start.