Skip to content

CLI toolUsage-basedIntermediate

ShellGPT

Turns a plain-English request into the terminal command you need, and can run it for you

View original on GitHub

Install request

Your browser blocked copying. Select the text and copy it yourself.

Paste this into your AI agent (Claude Code, Codex or similar). It asks the agent to read the files and wait for your OK before installing.

What it does

ShellGPT is a command-line helper that answers questions and writes shell commands from plain-English requests. Ask it to find all JSON files or update your system and it suggests the command for your operating system and shell, then lets you run it, get it explained or cancel. It can also summarise piped text, analyse logs and hold a chat. It uses OpenAI by default and can use local models. It suits people who forget command syntax and work in the terminal.

It knows which system and shell you use, and asks before it runs any command it writes for you.

Before you start

  • A computer with macOS, Windows or Linux.
  • Python 3.10 or later
  • An OpenAI API key, or a local model through Ollama
  • Pay per use. The AI service it calls charges for what you use.

How to start

  1. Install itPaste the install request into an AI agent you already use, or run the official command yourself or follow the official guide.macOS, Windows, Linuxpip install shell-gpt

    Install command

    Your browser blocked copying. Select the text and copy it yourself.

    This is the official install command, copied from the creator's instructions. Paste it where the instructions say.

  2. Set it upFollow the first-run steps in the official guide.
  3. Give it a first taskDescribe what you want in your own words, and check the first result before relying on it.

Steps follow the creator's instructions.

Stuck setting it up?

Tell us what happened. We confirm scope and price before any paid work.

Get help
View original

Install request

Your browser blocked copying. Select the text and copy it yourself.

Paste this into your AI agent (Claude Code, Codex or similar). It asks the agent to read the files and wait for your OK before installing.