NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules, #1947 by repository stars
Latest stable
v1.11.0
Last release 3 months ago
31 Jul 2026
Release timing varies
gaps range from 2 weeks to 3 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
140 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
New `--new-thread` Flag: Added the --new-thread flag to generate a new thread with a random name and automatically target it. This feature is particul
--new-thread Flag: Added the --new-thread flag to generate a new thread with a random name and automatically target it. This feature is particularly useful when using prompt files, allowing users to start fresh without the sticky history of previous interactions. It ensures that follow-up questions are isolated to the new thread.--new-thread with --thread or --set-thread flags. This ensures clarity in thread targeting, avoiding unexpected behavior when specifying a new thread and targeting another thread concurrently.generateUniqueSlug function from the client and centralized the logic in utils.GenerateUniqueSlug, improving code maintainability.--new-thread, --thread, and --set-thread flags.--new-thread is used with --set-thread.--new-thread is used with --thread.brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nothing published for this version
We're excited to announce the release of ChatGPT CLI v1.7.1! This version introduces a highly-requested feature that enhances how you interact with Ch
We're excited to announce the release of ChatGPT CLI v1.7.1! This version introduces a highly-requested feature that enhances how you interact with ChatGPT using prompt files. Additionally, this update includes several minor improvements and bug fixes to ensure a smoother experience.
--prompt FlagWith the new --prompt flag, you can now use a file to provide detailed context for your conversations with ChatGPT. This feature allows for greater flexibility and ease when working with complex prompts or reusable context across different conversations.
How to use the --prompt flag:
--prompt flag:chatgpt --prompt path/to/your/prompt.md "Your follow-up question here"
prompt.md and use it as the initial context for the conversation.Example:
git diff command and using a prompt to guide the response:git diff | chatgpt --prompt ../prompts/write_pull-request.md
For a variety of ready-to-use prompts, visit our prompts repository. These examples can serve as great starting points or inspiration for your own custom prompts!
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
We're excited to announce the release of ChatGPT CLI v1.7.0! This update introduces significant improvements in configuration handling, enhances flexi
We're excited to announce the release of ChatGPT CLI v1.7.0! This update introduces significant improvements in configuration handling, enhances flexibility in user input, and includes a few important bug fixes and enhancements.
--set-model <model-name> to update the default model permanently, or --model <model-name> to apply the change only for the current session.viper and cobra. The new approach ensures that changes to command-line flags are properly synced with viper's internal state.brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Nothing published for this version
Nothing published for this version
Clear Command in Interactive Mode: You can now use the clear command in interactive mode to clear the screen, making it easier to manage long sessions
clear command in interactive mode to clear the screen, making it easier to manage long sessions. Simply type clear and press Enter to refresh the screen, leaving only the command prompt at the top.clear command alongside exit and /q, providing users with clear guidance for managing their sessions.brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
In this release, we've introduced support for overriding the default paths for configuration and data directories using environment variables. This is
In this release, we've introduced support for overriding the default paths for configuration and data directories using environment variables. This is particularly useful for users who prefer to manage their settings and data in non-default locations. The following environment variables are now supported:
OPENAI_CONFIG_HOME: Defines a custom path for configuration files (e.g., config.yaml). Default is ~/.chatgpt-cli.OPENAI_DATA_HOME: Defines a custom path for storing data, including chat history. Default is ~/.chatgpt-cli/history.The internal logic for retrieving default directories has been refactored. The previous methods such as GetHistoryDir and GetChatGPTDirectory have been replaced with clearer naming and paths:
GetConfigHome: Retrieves the configuration home directory.GetDataHome: Retrieves the data home directory (for history storage).We've improved the integration testing setup by ensuring that any pre-existing environment variables related to config and data directories (OPENAI_CONFIG_HOME, OPENAI_DATA_HOME) are unset before running tests. This guarantees a clean and isolated test environment, making the tests more reliable and predictable.
The legacy history migration logic has been enhanced to ensure smooth transitions when moving from older versions of the CLI to v1.6.7. If the legacy history file exists, it will be migrated to the new directory structure, ensuring all your existing conversation history is preserved.
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Output Prompt Configuration: You can now customize the output prompt in interactive mode using the output_prompt configuration setting. This allows yo
Output Prompt Configuration:
You can now customize the output prompt in interactive mode using the output_prompt configuration setting. This allows you to prepend custom text or formatting to the AI’s response.
Example configuration:
output_prompt: '\nhi there: '
This example will display:
hi there: <response>
Fixed Newline Escaping:
In the command prompt, \\n is now correctly replaced with an actual newline during execution, allowing multi-line output prompts.
Code Refactoring:
output_prompt configuration option.brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
TLS Certificate Verification Control:
skip_tls_verify, to allow users to skip TLS certificate verification for HTTPS requests.false to ensure secure communication. Users can enable it to bypass certificate validation in environments with self-signed certificates or for development purposes.configmanager_test.go to account for the new skip_tls_verify setting, ensuring proper behavior for environment variable overrides and user-defined configurations.This version brings enhanced flexibility for certificate management and broadens compatibility with more AI services!
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Improved Debugging Capabilities:
Improved Debugging Capabilities:
--debug flag now provides detailed insights into both request and response data, making it easier to diagnose and troubleshoot issues. This feature is invaluable for developers needing to verify the exact cURL commands and responses generated during interactions.Automatic Omission of Default Values in cURL:
presence_penalty and frequency_penalty fields from cURL commands when they are set to their default values (0.0). This streamlines the requests, reducing potential confusion and making the generated cURL commands cleaner and more concise.Perplexity AI Support:
llama-3.1-sonar-small-128k-online through the CLI. This extends the tool’s versatility, allowing for seamless integration with another AI provider.Documentation Updates:
General Improvements:
This release is a step forward in making the ChatGPT CLI more powerful and developer-friendly, with a strong focus on providing better debugging tools and cleaner command generation. Enjoy the new capabilities!
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Nothing published for this version
Debug Mode: Introduced a --debug flag that allows users to print raw request and response data. This includes the request JSON body, the endpoint URL,
--debug flag that allows users to print raw request and response data. This includes the request JSON body, the endpoint URL, and the raw response. Useful for troubleshooting and verifying API calls.--debug flag, ensuring that the raw request and response data are accurately printed.debug flag to the configuration file, which can be enabled through environment variables or directly in the config file.brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
This version improves the CLI’s usability by providing more transparency into the API requests and responses, especially useful for developers and power users who want to inspect the raw data interactions with the OpenAI API.
We are excited to announce the release of v1.6.2 of the ChatGPT CLI! This update brings some new features and enhancements to improve your experience
We are excited to announce the release of v1.6.2 of the ChatGPT CLI! This update brings some new features and enhancements to improve your experience with the CLI.
Automatic Thread Creation:
auto_create_new_thread. When enabled, this feature automatically generates a unique thread identifier for each interactive session, helping you better organize your conversations.auto_create_new_thread to true in your configuration.Token Usage Tracking:
track_token_usage configuration option has been introduced. When enabled, this feature tracks and displays the total token usage after each query when using --query mode.track_token_usage to true to activate this feature.auto_create_new_thread and track_token_usage configuration options.brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Introduced variables for interactive mode:
Command Prompt Customization:
%date: The current date in the format YYYY-MM-DD.%time: The current time in the format HH:MM:SS.%datetime: The current date and time in the format YYYY-MM-DD HH:MM:SS.%counter: The total number of queries in the current session.%usage: The usage in total tokens used (only works in query mode).README.md to clarify the new variables and the need to single-quote the command prompt configuration.Version Command Update:
GitCommit string correctly, ensuring it outputs "commit {hash}" unless set to "homebrew".Dependency Updates:
github.com/spf13/viper from v1.18.2 to v1.19.0.golang.org/x/exp from v0.0.0-20240525044651-4c93da0ed11d to v0.0.0-20240531132922-fd00a4e0eefc.Documentation:
release_procedures.md to use the SHA256 of the tar file instead of the binary for Homebrew formula updates.Bug Fixes:
This release introduces important enhancements to the command prompt configuration, improves version handling, updates dependencies, and fixes various documentation issues. Please refer to the updated README.md for detailed usage of the new interactive mode variables.
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Error messages are now printed to stderr instead of stdout. This change improves error logging and handling, making it easier to differentiate between
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Sure, here's a draft for the GitHub release of version v1.5.5:
Sure, here's a draft for the GitHub release of version v1.5.5:
Query function in the client package now returns token usage data along with the response content. This allows developers to track usage metrics more effectively. Note that the token usage is only printed when it's used in conjunction with the interactive mode.brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
This release introduces the --delete-thread flag, enhancing the thread management capabilities of the ChatGPT CLI. Users can now delete specified thre
This release introduces the --delete-thread flag, enhancing the thread management capabilities of the ChatGPT CLI. Users can now delete specified threads directly from the command line, making it easier to manage the conversation context dynamically. Below are the details of the updates in this release:
Features
Delete Thread: Added the --delete-thread flag to allow users to delete specific threads. This addition improves the manageability of threads within the CLI, providing a cleaner and more efficient user experience. The deletion process is idempotent, meaning that attempting to delete non-existent threads will not result in an error, making script integration smoother.
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
We are thrilled to announce the release of ChatGPT CLI v1.5.3. This update introduces an enhanced interactive mode, leveraging the readline library to
We are thrilled to announce the release of ChatGPT CLI v1.5.3. This update introduces an enhanced interactive mode, leveraging the readline library to provide dynamic prompts and advanced input handling features. With these improvements, users can now enjoy a more intuitive and efficient CLI experience.
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
We're excited to announce the release of version 1.5.2 of ChatGPT-CLI!
We're excited to announce the release of version 1.5.2 of ChatGPT-CLI!
config.yamlconfig.yaml file are preserved after any read-write operations performed by chatgpt-cli. This enhancement is especially useful for users who prefer manually editing their configuration files, providing a more intuitive and user-friendly experience.brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
We're excited to announce the latest updates to the ChatGPT Command Line Interface (CLI)! This release introduces new features and enhancements that i
We're excited to announce the latest updates to the ChatGPT Command Line Interface (CLI)! This release introduces new features and enhancements that improve customization, flexibility, and ease of use. Here's what's new:
--set-context-window flag. This enhancement allows for more precise control over the amount of conversational context the model considers, enabling users to tailor the chat experience to their specific needs.Codebase Improvements: For developers, we've introduced a new variable contextWindow in the main.go file, alongside the necessary logic to support the adjustable context window size feature. Additionally, the configmanager.go file has been updated with a new method WriteContextWindow, which handles the updating of this setting in the configuration.
Testing Enhancements: Our commitment to quality and stability is reinforced with updates to the configmanager_test.go and integration_test.go files, ensuring comprehensive test coverage for the new context window functionality.
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Nothing published for this version
Nothing published for this version
This release introduces significant updates including bug fixes, a breaking change for better API payload handling, and a new feature to improve conte…
This release introduces significant updates including bug fixes, a breaking change for better API payload handling, and a new feature to improve context management and max token management. Additionally, it includes a migration strategy for existing configurations to smoothly transition to the new context window setting.
New Feature: Introduced context_window to limit the size of the context. This replaces the previous max_tokens setting for context management, offering more precise control over the memory footprint of conversations (PR #).
Configuration Migration: For users migrating from an older version, config.yaml now automatically updates to use context_window. If context_window is not set, it defaults to the value of max_tokens, and max_tokens is reset to 4096. This ensures a seamless transition while encouraging users to leverage the new context management feature (PR #).
--list-threads No Longer Requires API Key: Fixed a bug where the --list-threads command unnecessarily required an API key, streamlining the process for listing threads without additional authentication (PR #).
API Payload Handling (Breaking Change): The --max-tokens setting now correctly applies to the payload of the outgoing API call instead of the size of the context. This change may affect existing workflows that rely on the old behavior. Users are encouraged to review their usage and adjust accordingly
context_window and max_tokens logic, ensuring consistency across API calls.brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Nothing published for this version
Nothing published for this version
Nothing published for this version
We are excited to announce the release of chatgpt-cli version 1.4.2, which introduces an eagerly awaited feature: Command-Line Autocompletion for flag
We are excited to announce the release of chatgpt-cli version 1.4.2, which introduces an eagerly awaited feature: Command-Line Autocompletion for flags. This update is designed to enhance the user experience by streamlining interactions with the CLI, making it faster and more intuitive to use the chatgpt-cli.
For Bash, Zsh, and Fish Shells: Execute the following command in your terminal to activate autocompletion for the current session:
. <(chatgpt-cli --set-completions [shell])
Replace [shell] with bash, zsh, or fish according to your shell type.
For PowerShell: Execute:
chatgpt-cli --set-completions powershell | Out-String | Invoke-Expression
To ensure autocompletion is enabled in every new shell session, add the autocompletion script to your shell's startup file (~/.bashrc, ~/.zshrc, config.fish, or your PowerShell profile).
To get started with version 1.4.2 of chatgpt-cli, visit our Installation Guide. Existing users can update to the latest version by following the standard update procedures for their specific setup.
We hope you enjoy the enhanced productivity with the new autocompletion feature. As always, we welcome your feedback and contributions to make chatgpt-cli even better.
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Thank you for using chatgpt-cli!
Nothing published for this version
Nothing published for this version
We're thrilled to announce the latest update to chatgpt-cli, which brings significant enhancements and new features to improve your CLI experience. Th
We're thrilled to announce the latest update to chatgpt-cli, which brings significant enhancements and new features to improve your CLI experience. This update introduces the ability to manage conversation threads more efficiently with two new flags: --list-threads for displaying active threads and --set-thread for specifying the active thread. These enhancements are designed to streamline your workflow and provide you with greater control over your conversational contexts.
Thread Management Made Easy: Navigate through and manage your conversation threads effortlessly with the new --list-threads flag. This feature allows you to view all your active threads, clearly indicating the current active thread for better orientation.
Customize Your Conversation Context: With the --set-thread flag, switching between different conversation threads is now seamless. Specify the thread you wish to activate, and chatgpt-cli will set it as the current context for your session.
Improved Documentation: The README has been updated to include instructions and examples for the newly introduced thread management features, providing you with all the information you need to get started.
Code Quality Improvements: Under the hood, the chatgpt-cli codebase has been refined for better performance and reliability. These improvements ensure a smoother and more stable experience while using the CLI tool.
To start using these new features, update your chatgpt-cli to the latest version by following the installation instructions provided in our GitHub repository.
Your feedback is invaluable to us as we continue to improve chatgpt-cli. If you have any suggestions or encounter any issues, please don't hesitate to open an issue on our GitHub repository.
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
If you're affected by the breaking change with the removal of SetAPIKey, here are the steps to migrate:
SetAPIKey method has been removed from the Caller interface (HTTP client). This change may require updates to existing code where the SetAPIKey method was previously used. Users will need to adjust their implementation to accommodate this change.If you're affected by the breaking change with the removal of SetAPIKey, here are the steps to migrate:
SetAPIKey method within the Caller interface.brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
We appreciate your support and feedback as we continue to improve our software. Please reach out if you encounter any issues or have suggestions for future releases.
Nothing published for this version
We're excited to introduce new configuration options to give you more control over your GPT model interactions.
We're excited to introduce new configuration options to give you more control over your GPT model interactions.
Temperature Configuration: Adjust the randomness of the output. Values range between 0 and 2.0, with the default set to 1.0. Higher values, like 0.8, make the output more random, whereas lower values, like 0.2, make it more deterministic.
Frequency Penalty: This setting, ranging from -2.0 to 2.0 (defaulting to 0), allows you to penalize tokens based on their existing frequency in the text. Positive values decrease the model's likelihood to repeat the same line verbatim.
TopP (Nucleus Sampling): An alternative to temperature sampling. The model considers the tokens with top_p probability mass. So, setting it to 0.1 means only the tokens comprising the top 10% probability mass are considered. Defaults to 1.
Presence Penalty: This value, ranging from -2.0 to 2.0 (defaulting to 0), lets you penalize tokens based on whether they've appeared in the text so far. Positive values encourage the model to discuss new topics.
Update your configuration settings with the new options to take advantage of these features.
Feel free to adjust the content as needed to match your project's style and conventions!
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Thank you for your continued support. As always, we appreciate feedback and suggestions to make our tool even better!
Nothing published for this version
In this release, we've enhanced the visibility of error messages for non-2XX HTTP responses. Previously, only the error type was displayed. With this
In this release, we've enhanced the visibility of error messages for non-2XX HTTP responses. Previously, only the error type was displayed. With this update, you'll also see a more descriptive error message.
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Nothing published for this version
Configurable Role: You are now able to configure the role of your chatgpt-cli. By default, the role is "You are a helpful assistant". This feature pro
In this new version, we have updated several dependencies to ensure you are using the latest and most secure versions. Although these updates often go unnoticed, they are an essential part of maintaining the health of chatgpt-cli.
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
Nothing published for this version
Nothing published for this version
In this release, our efforts have largely been focused on improving the interactive mode for a better user engagement experience. Here are the key cha
In this release, our efforts have largely been focused on improving the interactive mode for a better user engagement experience. Here are the key changes:
Interactive Mode Instructions: Users are now clearly briefed on how to exit interactive mode. Two ways have been implemented - the exit command and the universal Ctrl+C action.
Timestamp on Messages: For better tracking and reference, timestamps are now printed for each query in interactive mode. The timestamp corresponds to when a user finishes typing their query.
Exit Feedback: In response to user actions to exit interactive mode, the program now responds with a friendly "Bye!" message.
brew upgrade chatgpt-cli
For a quick and easy installation without compiling, you can directly download the pre-built binary for your operating system and architecture.
One column per quarter.