wizard142/genie

Genie is a terminal helper for people who find Linux and Windows commands hard to remember. Instead of memorizing exact syntax, you type what you want in plain English, prefixed with /genie on Linux or just genie on Windows, and it shows you the real command it would run, along with a short explanation of what that command does. Nothing runs until you press enter to confirm, type n to cancel, or c to copy the command instead. The README explains that genie is built to teach as you go rather than hide the terminal from you, so over time a person using it should start remembering the commands themselves. It works across many different Linux distributions, including Arch-based systems, Debian and Ubuntu, Fedora, openSUSE, Alpine, Void, and Gentoo, automatically using the right package manager for whichever one you have. It also runs natively on Windows, generating PowerShell commands and using winget to install programs. Safety is a core focus. Commands are sorted into levels: simple read-only commands just get shown and confirmed, ones that change your system get a yellow warning, destructive commands like deleting a folder require typing yes first, and a short list of truly catastrophic commands, like wiping a whole drive, are blocked outright no matter what the AI suggests. Genie needs an AI provider to turn your English request into a command. It supports several options, including free tiers from Groq, Google Gemini, and OpenRouter, a paid option through Anthropic Claude, and Ollama for running a model entirely on your own computer at no cost. You can set up more than one provider, and genie will automatically try another if the first one is busy or down. Common tasks like installing software or checking disk space also work without any AI provider configured at all. The whole tool is a single Python file with no extra dependencies to install.