sgpt

Ask a question

$ sgpt "[How do I list files?]"

$ sgpt -s "[list all PDF files]"

$ sgpt -se "[find large files]"

$ sgpt -c "[python function to sort list]"

$ sgpt --chat [session_name] "[message]"

$ sgpt --role [code] "[question]"

$ cat [file.txt] | sgpt "[summarize this]"

sgpt [-s] [-c] [--chat name] [options] prompt

sgpt (Shell GPT) is a command-line interface for interacting with OpenAI's ChatGPT models, optimized for developer and system administration workflows. It operates in several modes: general queries for quick answers, shell mode (-s) for generating executable commands with explanations, and code mode (-c) for producing programming solutions with automatic language detection.
Chat sessions maintain conversation context across multiple invocations, allowing follow-up questions and iterative refinement. Roles customize the AI's behavior for specific tasks, with predefined roles for common scenarios and support for user-defined custom roles.
The tool integrates naturally with Unix pipelines, accepting input via stdin to process file contents, command output, or any streamed data through AI analysis. This makes it useful for tasks like summarizing logs, explaining error messages, or generating documentation from code.

-s, --shell

Generate shell command.

Shell and execute.

Generate code.

Chat session.

Use role.

Specify model.

Response randomness.

Disable caching.

OPENAI_API_KEY

Environment variable providing the OpenAI API key for authentication.

Configuration file for default model, temperature, cache settings, and other preferences.

Directory containing custom role definitions as text files.

Requires OpenAI API key. Costs per token. Internet connection needed.

sgpt was created by Farkhod Sadykov for AI-assisted shell usage. It brings ChatGPT capabilities directly to the command line.

chatgpt(1), github-copilot-cli(1)