RepoPicks Radar

Updated every day around 23:30 UTC

Guides

ShellGPT

TheR1D/shell_gptReviewed by AI

Checked by RepoPicks Radar on

What is ShellGPT?

ShellGPT (sgpt) puts an AI assistant inside your terminal. You type a question and it answers; with -s it writes the exact command for your system and offers to run it, and with -c it returns only code. You can pipe files, logs or a git diff into it, keep named conversations, and press Ctrl+L to turn what you typed into a command. It works on Windows, Mac and Linux after a pip install. By default it uses OpenAI's paid API; a local model through Ollama is possible but the author says it is not optimized for that.

How easy is it to install ShellGPT?

C · install 1 or 2 tools · Windows

  • Windows C
  • macOS C
  • Linux C

Same on Windows, Mac and Linux: install Python, run pip install shell-gpt, paste an OpenAI key when asked, then type sgpt with your question. A ready Docker image is offered as an alternative for people who prefer containers.

ShellGPT on GitHub

Stars
12,309on Nov 10, 2026
Downloads
2,8383 this week
Growth
+5stars in 6 days

Stars over time

12,30612,30712,30812,30912,310 Nov 8Nov 9Nov 10 12,30612,30712,30812,30912,310 Nov 8Nov 9Nov 10

Facts

Runs on
Windows, macOS, Linux
You need to install
Python
To build from source
Python, Docker, FFmpeg
Disk space
100 MB–300 MB · estimate
Accounts or keys
OpenAI
Cost
Free, API costs extra · The tool is MIT and free; it calls OpenAI's API, which is paid per use. A free local model through Ollama is documented in the wiki but the README warns it "is not optimized for local models and may not work as expected".
License
MIT (Permissive)
Last change on GitHub
Jul 2, 2026

ShellGPT risk signals (4)

  • Attentionai can run commands on your computer

    The function-calling feature ships a function that runs shell commands: "we are allowing LLM to execute any Shell commands in our system", with the example of the model installing software by itself (brew install jq). The README warns: "LLM might execute destructive commands, so please use it at your own risk", and the config file has OPENAI_USE_FUNCTIONS=true.

    AI review

  • Infowhatever you pipe in is sent to the provider

    The documented uses pipe local content to the model, for example "git diff | sgpt", "docker logs -n 20 my_app | sgpt" and "sgpt \"summarise\" < document.txt"; that text leaves your machine for OpenAI unless you point it at a local model.

    AI review

  • Infoedits your shell startup file

    README: running sgpt --install-integration "will add few lines to your .bashrc or .zshrc file" so Ctrl+L can replace your input line with a suggested command.

    AI review

  • Infoapi key stored in plain text

    The key you paste "will then be stored in ~/.config/shell_gpt/.sgptrc", a plain text config file that also holds the other settings.

    AI review

Evidence is shown in its original language.

What Radar could not check about ShellGPT

  • What the OpenAI usage costs in a normal month of use
  • How well the suggested commands match your own system and shell
  • Whether a local Ollama model gives usable results, which the author says is not optimized
  • Whether it still works with the newest OpenAI models, as the last commit is from July 2026

Similar projects

The RepoPicks app

Coming soon: install in 1 click with the RepoPicks app.

Before you download

See the release page on GitHub