ShellGenie

ShellGenie is a small experiment in putting an LLM where people already work: the command line.

It's an interactive shell, written in Python with prompt_toolkit, that behaves like a normal console. Ordinary commands like dir or cd run directly, with tab completion and a saved command history. Prefix a line with ! and it becomes a request in plain English instead, such as !list files in the current directory. A local language model, run through llama.cpp and downloaded from Hugging Face on first use, turns the request into a shell command for the current platform.

The suggested command is shown first and runs only after you confirm it. That keeps the model in the role of an assistant that drafts commands, never one that acts on its own, which matters in a tool that can delete files.

Because inference is local, nothing typed into the shell leaves the machine. The shell runs on Windows, macOS and Linux, with launch scripts for each.