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
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)
- Can replace
- Warp, Copilot, ChatGPT Plus
- 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