From fb941cea9928644d86c9ff6ed0fe2d859e5ca076 Mon Sep 17 00:00:00 2001
From: Petr Mironychev <9195189+Palm1r@users.noreply.github.com>
Date: Mon, 1 Dec 2025 16:08:21 +0100
Subject: [PATCH] doc: Update docs for using OpenAI GPT-5.1 and codex

---
 README.md                    | 20 +++++++++++++++++++-
 docs/openai-configuration.md | 18 +++++++++++++++++-
 2 files changed, 36 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index ba8ed93..bcd1553 100644
--- a/README.md
+++ b/README.md
@@ -132,12 +132,30 @@ QodeAssist supports multiple LLM providers. Choose your preferred provider and f
 - **[Ollama](docs/ollama-configuration.md)** - Local LLM provider
 - **[llama.cpp](docs/llamacpp-configuration.md)** - Local LLM server
 - **[Anthropic Claude](docs/claude-configuration.md)** - Сloud provider
-- **[OpenAI](docs/openai-configuration.md)** - Сloud provider
+- **[OpenAI](docs/openai-configuration.md)** - Сloud provider (includes Responses API support)
 - **[Mistral AI](docs/mistral-configuration.md)** - Сloud provider
 - **[Google AI](docs/google-ai-configuration.md)** - Сloud provider
 - **LM Studio** - Local LLM provider
 - **OpenAI-compatible** - Custom providers (OpenRouter, etc.)
 
+### Recommended Models for Best Experience
+
+For optimal coding assistance, we recommend using these top-tier models:
+
+**Best for Code Completion & Refactoring:**
+- **Claude 4.5 Haiku or Sonnet** (Anthropic)
+- **GPT-5.1-codex or codex-mini** (OpenAI Responses API)
+- **Codestral** (Mistral)
+
+**Best for Chat Assistant:**
+- **Claude 4.5 Sonnet** (Anthropic) - Outstanding reasoning and natural conversation flow
+- **GPT-5.1-codex** (OpenAI Responses API) - Latest model with advanced capabilities
+- **Gemini 2.5 or 3.0** (Google AI) - Latest models from Google
+- **Mistral large** (Mistral) - Fast and capable
+
+**Local models:**
+- **Qwen3-coder** (Qwen) - Best local models
+
 ### Additional Configuration
 
 - **[Project Rules](docs/project-rules.md)** - Customize AI behavior for your project
diff --git a/docs/openai-configuration.md b/docs/openai-configuration.md
index c385542..efbc177 100644
--- a/docs/openai-configuration.md
+++ b/docs/openai-configuration.md
@@ -1,11 +1,15 @@
 # Configure for OpenAI
 
+QodeAssist supports both OpenAI's standard Chat Completions API and the new Responses API, giving you access to the latest GPT models including GPT-5.1 and GPT-5.1-codex.
+
+## Standard OpenAI Configuration
+
 1. Open Qt Creator settings and navigate to the QodeAssist section
 2. Go to Provider Settings tab and configure OpenAI api key
 3. Return to General tab and configure:
    - Set "OpenAI" as the provider for code completion or/and chat assistant
    - Set the OpenAI URL (https://api.openai.com)
-   - Select your preferred model (e.g., gpt-4o)
+   - Select your preferred model (e.g., gpt-4o, gpt-5.1, gpt-5.1-codex)
    - Choose the OpenAI template for code completion or/and chat
 
 <details>
@@ -14,3 +18,15 @@
 <img width="829" alt="OpenAI Settings" src="https://github.com/user-attachments/assets/4716f790-6159-44d0-a8f4-565ccb6eb713" />
 </details>
 
+## OpenAI Responses API Configuration
+
+The Responses API is OpenAI's newer endpoint that provides enhanced capabilities and improved performance. It supports the latest GPT-5.1 models.
+
+1. Open Qt Creator settings and navigate to the QodeAssist section
+2. Go to Provider Settings tab and configure OpenAI api key
+3. Return to General tab and configure:
+   - Set "OpenAI Responses" as the provider for code completion or/and chat assistant
+   - Set the OpenAI URL (https://api.openai.com)
+   - Select your preferred model (e.g., gpt-5.1, gpt-5.1-codex)
+   - Choose the OpenAI Responses template for code completion or/and chat
+