docs: Updated intro

README.md

@@ -8,16 +8,24 @@
 
 <br/>
 
-**AI orchestration for Claude Code** - A Model Context Protocol server that gives your CLI of choice (e.g. [Claude Code](https://www.anthropic.com/claude-code)) access to multiple AI models for enhanced code analysis, problem-solving, and collaborative development. Zen
-works with Claude Code, Gemini CLI, Codex CLI, and IDE clients like [Cursor](https://cursor.com) and the [Claude Dev extension for VS Code](https://marketplace.visualstudio.com/items?itemName=Anthropic.claude-vscode).
+**Why rely on one AI model when you can use them all?**
 
-**True AI collaboration with conversation continuity** - Claude stays in control but gets perspectives from the best AI for each subtask. Context carries forward seamlessly across tools and models, enabling complex workflows like: code reviews with multiple models → automated planning → implementation → pre-commit validation.
+A Model Context Protocol server that supercharges tools like [Claude Code](https://www.anthropic.com/claude-code), [Codex CLI](https://developers.openai.com/codex/cli), and IDE clients such 
+as [Cursor](https://cursor.com) or the [Claude Dev VS Code extension](https://marketplace.visualstudio.com/items?itemName=Anthropic.claude-vscode). **Zen MCP connects your favorite AI tool 
+to multiple AI models** for enhanced code analysis, problem-solving, and collaborative development.
 
-> **You're in control.** Claude orchestrates the AI team, but you decide the workflow. Craft powerful prompts that bring in Gemini Pro, GPT 5, Flash, or local offline models exactly when needed.
+**True AI collaboration with conversation continuity** - Zen supports **conversation threading** so your 
+CLI can **discuss ideas with multiple AI models, exchange reasoning, get second opinions, and even run collaborative debates between models** to help you reach deeper insights and better solutions. 
+
+Your CLI always stays in control but gets perspectives from the best AI for each subtask. Context carries forward seamlessly across tools and models, enabling complex workflows like: code reviews with multiple models → automated planning → implementation → pre-commit validation.
+
+> **You're in control.** Your CLI of choice orchestrates the AI team, but you decide the workflow. Craft powerful prompts that bring in Gemini Pro, GPT 5, Flash, or local offline models exactly when needed.
 
 <details>
 <summary><b>Reasons to Use Zen MCP</b></summary>
 
+A typical workflow with Claude Code as an example:
+
 1. **Multi-Model Orchestration** - Claude coordinates with Gemini Pro, O3, GPT-5, and 50+ other models to get the best analysis for each task
 
 2. **Context Revival Magic** - Even after Claude's context resets, continue conversations seamlessly by having other models "remind" Claude of the discussion
@@ -68,13 +76,26 @@ and review into consideration to aid with its final pre-commit review.
 > **You're** the one who crafts the powerful prompt that makes Claude bring in Gemini, Flash, O3 — or fly solo.
 > You're the guide. The prompter. The puppeteer.
 > #### You are the AI - **Actually Intelligent**.
+</details>
 
 #### Recommended AI Stack
 
-For best results, use Claude Code with:
-- **Opus 4.1** - All agentic work and orchestration
-- **Gemini 2.5 Pro** - Deep thinking, code reviews, debugging, pre-commit analysis
+<details>
+<summary>For Claude Code Users</summary>
 
+For best results when using [Claude Code](https://claude.ai/code):  
+
+- **Sonnet 4.5** - All agentic work and orchestration
+- **Gemini 2.5 Pro** - Deep thinking, additional code reviews, debugging and validations, pre-commit analysis
+</details>
+
+<details>
+<summary>For Codex Users</summary>
+
+For best results when using [Codex CLI](https://developers.openai.com/codex/cli):  
+
+- **GPT-5 Codex Medium** - All agentic work and orchestration
+- **Gemini 2.5 Pro** - Deep thinking, additional code reviews, debugging and validations, pre-commit analysis
 </details>
 
 ## Quick Start (5 minutes)