djcopley/ShellOracle

What it solves

ShellOracle eliminates the need to memorize complex shell commands or search through documentation by allowing users to generate precise terminal commands using natural language descriptions.

How it works

It functions as a widget for BASH, ZSH, and fish shells. When a user presses a keyboard shortcut (CTRL+F), they can describe the command they want in plain English. The tool then uses a configured LLM provider to generate the corresponding shell command and inserts it directly into the prompt.

Who it’s for

Developers and system administrators using macOS or Linux who want to speed up their command-line workflow and reduce the time spent looking up syntax.

Highlights

• Multi-Provider Support: Compatible with local providers like Ollama, LocalAI, and LM Studio, as well as cloud APIs like OpenAI, Deepseek, Grok (XAI), and Google.
• Shell Integration: Deeply integrates with BASH, ZSH, and fish via a dedicated keyboard shortcut.
• Unix Pipe Support: Can be used in a pipeline (e.g., echo "text" | shor) for advanced command chaining.
• Context Awareness: Carries over existing text from the shell buffer to the prompt for better context.
• Command History: Maintains a history of prompts for easy reference and cycling.