shell-gpt — The AI Toolchain

shell-gpt 1.5.0

Wed, 28 Jan 2026 00:57:48 GMT

shell-gpt 1.5.0 lets you edit AI-generated shell commands before execution and drops the `instructor` dependency. • Adds ability to modify a generated shell command before running it, letting you tweak AI output in-place rather than accepting or rejecting wholesale. Breaking changes: • The `instructor` package has been removed from dependencies; users who relied on function calling must re-run `sgpt --install-functions` to reinstall default functions and manually update any custom functions.

shell-gpt 1.4.5

Tue, 08 Apr 2025 10:50:58 GMT

shell-gpt 1.4.5 adds LiteLLM support, unlocking hundreds of additional AI model backends. • Supports all LiteLLM-compatible models, enabling use of any backend provider LiteLLM supports (e.g., Azure, Anthropic, Cohere, and more).

shell-gpt 1.4.4

Sat, 10 Aug 2024 23:32:04 GMT

shell-gpt 1.4.4 enables function calling on Groq and other non-OpenAI models, and switches the default model to gpt-4o. • Supports function calling on Groq and other compatible models via the new OpenAI function-calling format. • Changes the default model to gpt-4o for all interactions. Breaking changes: • The default model is changed to `gpt-4o`; existing setups that relied on the previous default model will now use gpt-4o unless overridden in configuration.

shell-gpt 1.4.3

Sat, 06 Apr 2024 16:55:47 GMT

shell-gpt 1.4.3 adds Ctrl+C interruption of streaming LLM responses in REPL mode • Adds Ctrl+C interruption support to cancel an actively streaming LLM response while in REPL mode.

shell-gpt 1.4.0

Thu, 22 Feb 2024 02:56:09 GMT

shell-gpt 1.4.0 adds LiteLLM multi-backend support and per-run markdown control via new flags and config keys. • Adds `--md` and `--no-md` CLI flags to enable or disable markdown output on a per-invocation basis. • Adds `PRETTIFY_MARKDOWN` config key in `~/.config/shell_gpt/.sgptrc` to set the default markdown rendering behavior. • Adds `USE_LITELLM` config key in `~/.config/shell_gpt/.sgptrc` to enforce LiteLLM as the request backend, unlocking support for numerous non-OpenAI LLM providers; install via `pip install shell-gpt[litellm]`.

shell-gpt 1.3.1

Sat, 17 Feb 2024 02:06:46 GMT

shell-gpt 1.3.1 adds `API_BASE_URL` config variable to point at custom OpenAI-compatible endpoints. • Adds `API_BASE_URL` config variable to redirect shell-gpt to any OpenAI-compatible API base, enabling use with self-hosted or alternative LLM endpoints.

shell-gpt 1.3.0

Fri, 09 Feb 2024 22:48:41 GMT

shell-gpt 1.3.0 adds multi-backend LLM support via LiteLLM (including Ollama) and role-driven Markdown formatting control. • Supports multiple LLM backends via LiteLLM, enabling locally hosted open-source models such as Ollama alongside existing cloud providers. • Controls Markdown formatting per role: including `"APPLY MARKDOWN"` in a role's description enables formatted output; removing it disables it for that role. • Allows editing the default role description at `~/.config/shell_gpt/roles` to globally enable or disable Markdown formatting.

shell-gpt 1.2.0

Sun, 28 Jan 2024 04:33:52 GMT

shell-gpt 1.2.0 adds `--no-interaction` flag for redirectable shell output and stdin support in REPL mode. • Adds `--no-interaction` flag (used with `--shell`) to print the suggested command to stdout instead of interactive mode, enabling shell pipeline use like `sgpt -s "say hi" | pbcopy`. • REPL mode now accepts stdin, a PROMPT argument, or both simultaneously, allowing initial context to be piped in alongside an interactive session. Breaking changes: • Shell integration in `~/.bashrc` or `~/.zshrc` will stop working on upgrade; run `sgpt --install-integration` and manually remove the old integration function from your shell profile.

shell-gpt 1.1.0

Tue, 09 Jan 2024 02:10:38 GMT

shell-gpt 1.1.0 adds OpenAI function calling, letting the LLM execute shell commands and AppleScripts via new `--install-functions` and `--functions` flags. • Adds `--install-functions` flag to download and install default functions, enabling the LLM to execute shell commands and AppleScripts (macOS) directly on your system. • Adds `--functions` flag to enable or disable OpenAI function calling at invocation time. • Adds `OPENAI_FUNCTIONS_PATH` config variable to specify the directory where custom function definitions are loaded from. • Adds `OPENAI_USE_FUNCTIONS` config variable to enable or disable function calling globally in the config. • Adds `SHOW_FUNCTIONS_OUTPUT` config variable to control whether function execution output is displayed. • Adds shortcut `-c` as an alias for `--code`, `-lc` for `--list-chats`, and `-lr` for `--list-roles`. • Integrates the OpenAI Python library for API requests, providing more descriptive error messages with suggested solutions.

shell-gpt 1.0.0

Wed, 20 Dec 2023 05:18:53 GMT

ShellGPT 1.0.0 adds GPT-4 Turbo as default, markdown rendering, CODE_THEME config, multiline REPL input, and --version flag. • New `CODE_THEME` config variable in `~/.config/shell_gpt/.sgptrc` sets the syntax-highlighting theme for markdown output (default: `dracula`). • Adds `--version` flag to print the installed ShellGPT version. • Multiline input in REPL mode now supported using `"""` triple-quote delimiters. • Default model switched to `gpt-4-1106-preview` (GPT-4 Turbo) in `~/.config/shell_gpt/.sgptrc`. • Renders markdown for default and 'describe shell command' outputs. • Roles (prompts) optimised for OpenAI GPT-4 models using system roles via the OpenAI chat messages API. Breaking changes: • Previously created custom roles and chats are incompatible with v1.0.0 and must be re-created using the new version. • The `DEFAULT_MODEL` value in `~/.config/shell_gpt/.sgptrc` should be updated to `gpt-4-1106-preview`; older models may not perform correctly with the new system roles.

shell-gpt 0.9.4

Wed, 19 Jul 2023 01:20:27 GMT

shell-gpt 0.9.4 lets you point `--model` at any OpenAI-compatible local API, enabling air-gapped LLM usage. • Changes `--model` from an enum to a free-form string, allowing it to accept any model name including those served by self-hosted, OpenAI-compatible endpoints such as LocalAI. • Supports locally hosted language models via any OpenAI-compatible API server (e.g. LocalAI), enabling offline or cost-free LLM usage on your own hardware. Breaking changes: • The `--model` parameter type changed from an enum to a string; any tooling or scripts that relied on enum validation of `--model` values should be verified for compatibility.

shell-gpt 0.9.3

Wed, 14 Jun 2023 15:08:47 GMT

shell-gpt 0.9.3 adds support for gpt-3.5-turbo-16k, giving 4× the context window of the standard model. • Adds support for `--model gpt-3.5-turbo-16k`, enabling 4× the context of `gpt-3.5-turbo` (16k tokens) for longer prompts and conversations.

shell-gpt 0.9.2

Sun, 04 Jun 2023 23:49:09 GMT

shell-gpt 0.9.2 adds ZSH and Bash shell integration with hotkey-triggered command suggestions via `--install-integration`. • Adds `--install-integration` hidden flag to automatically update the user's shell profile and enable shell integration for ZSH and Bash. • New shell integration for ZSH and Bash lets users press `Ctrl+l` in the terminal to replace the current input buffer with an `sgpt`-suggested shell command. • Shell integration surfaces `sgpt` completions inside shell history and allows immediate in-line editing of suggested commands.

shell-gpt 0.9.1

Sun, 21 May 2023 18:54:24 GMT

shell-gpt 0.9.1 adds `--describe-shell` flag, in-prompt describe option, and `DEFAULT_EXECUTE_SHELL_CMD` config key • Adds `--describe-shell` (or `-d`) CLI flag to generate a natural-language explanation of any shell command, e.g. `sgpt -d "ls -la"`. • Adds `DEFAULT_EXECUTE_SHELL_CMD` config parameter to `.sgptrc` (default `false`); set to `true` to auto-execute `--shell` suggestions on Enter without typing `e`. • Adds `[D]escribe` option to the `--shell` execution prompt, letting users get an inline explanation of a suggested command before deciding to execute or abort. • Adds `[d]` describe shortcut inside `--repl` shell mode, printing an explanation of the last suggested command before execution. • Raises the maximum allowed value of `--temperature` to `2`. • Excludes comment lines (lines starting with `#`) when parsing `.sgptrc`, enabling inline documentation in the config file.

shell-gpt 0.9.0

Sun, 16 Apr 2023 16:35:43 GMT

shell-gpt 0.9.0 adds custom user-defined roles with `--create-role`, `--list-roles`, and `--show-role` flags. • Adds `--create-role ` flag to define custom roles stored as JSON files in `~/.config/shell_gpt/roles`, each specifying a system prompt and expected output type (answer, code, shell command, etc.). • Adds `--role ` flag to invoke any custom or built-in role when running a prompt. • Adds `--list-roles` flag to display all available roles, including user-created and built-in ones. • Adds `--show-role ` flag to display the details of a specific role. • Allows overriding the built-in `shell`, `code`, and `default` roles by editing their JSON files in `~/.config/shell_gpt/roles`. • Adds option to force the use of system role messages via a dedicated flag (not recommended by the project). • Improves stdin-plus-prompt handling, e.g. `echo hello | sgpt "another hello"`. Breaking changes: • All chats created with previous versions of ShellGPT are incompatible with 0.9.0 and will not work after upgrading. • The `--list-chat` flag is renamed to `--list-chats`; any scripts or aliases using `--list-chat` will break.

shell-gpt 0.8.8

Mon, 10 Apr 2023 15:20:19 GMT

shell-gpt 0.8.8 lets you combine stdin piping and a command-line prompt in a single invocation. • Accepts a prompt from both stdin and a command-line argument simultaneously, enabling piped output to be combined with an inline instruction in one command.

shell-gpt 0.8.7

Mon, 10 Apr 2023 10:26:28 GMT

shell-gpt 0.8.7 adds `DEFAULT_COLOR` config key to control OpenAI completion output color in the terminal. • Adds `DEFAULT_COLOR` to `~/.config/shell_gpt/.sgptrc` (or `$DEFAULT_COLOR` env var) to set the terminal color of OpenAI completions; supported values: black, red, green, yellow, blue, magenta, cyan, white, bright_black, bright_red, bright_green, bright_yellow, bright_blue, bright_magenta, bright_cyan, bright_white.

shell-gpt 0.8.5

Fri, 07 Apr 2023 22:13:11 GMT

shell-gpt 0.8.5 executes commands in the user's native $SHELL and improves Windows PowerShell and CMD integration. • Executes generated commands in the user's native `$SHELL` instead of always defaulting to `/bin/sh`. • Improves integration with PowerShell and CMD on Windows.

shell-gpt 0.8.3

Mon, 03 Apr 2023 00:33:49 GMT

shell-gpt 0.8.3 adds an interactive REPL mode for chat sessions via `--repl`, compatible with `--shell` and `--code`. • Adds `--repl ` option to start an interactive REPL mode for chat sessions, showing conversation history on entry; accepts `temp` as a session name for a throwaway session. • REPL mode shares sessions with `--chat`, allowing seamless hand-off between the two modes mid-conversation. • REPL mode supports `--shell` and `--code` flags for interactive shell command generation and code generation within the same session.

shell-gpt 0.8.0

Tue, 28 Mar 2023 18:07:06 GMT

shell-gpt 0.8.0 adds streaming OpenAI responses and makes `--shell` prompt for execution by default. • Adds streaming responses from the OpenAI API, eliminating the loading spinner and request preloads. • The `--shell` flag now prompts for execution by default, replacing the separate `--execute` option. • Improved prompt engineering delivers more accurate suggestions when using `--shell` and `--code` flags. Breaking changes: • The `--execute` option has been removed; execution prompting is now built into `--shell` by default.

shell-gpt 0.7.1

Wed, 15 Mar 2023 19:36:25 GMT

shell-gpt 0.7.1 adds OS and shell detection so suggestions are tailored to your environment • Adds system recognition so `sgpt` generates suggestions based on your OS and `$SHELL` environment variable. • Improves prompt engineering for more accurate suggestions.