v3.8.1: update CHANGELOG.md + README.md with Freebuff docs

CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## v3.8.1 (2026-05-24)
+
+**Freebuff Integration — FREE DeepSeek V4 Pro Access + Provider Presets Restored**
+
+### Freebuff Backend (New)
+- **`freebuff` backend type** added to `translate-proxy.py`
+- Connects to `https://freebuff.com` for free AI model access
+- **Free models available**: DeepSeek V4 Pro, DeepSeek V4 Flash, Kimi K2.6, MiniMax M2.7
+- **Agent run lifecycle management**: auto-starts/finishes agent runs per request
+- **Credential detection**: reads session token from `~/.config/manicode/credentials.json`
+- **Model-to-agent routing**: maps each model to its correct freebuff agent ID
+  - `deepseek/deepseek-v4-pro` → `base2-free-deepseek`
+  - `deepseek/deepseek-v4-flash` → `base2-free-deepseek-flash`
+  - `moonshotai/kimi-k2.6` → `base2-free-kimi`
+  - `minimax/minimax-m2.7` → `base2-free`
+
+### Setup for Freebuff
+1. `npm install -g freebuff` (already installed on system)
+2. `freebuff login` (opens browser for GitHub OAuth)
+3. Select "Freebuff (Free DeepSeek/Kimi)" preset in Codex Launcher GUI
+4. Pick a model and start coding — no API key needed!
+
+### Provider Presets Restored
+- All 17+ provider presets restored to `endpoints.json`
+- Previous issue: endpoints.json was overwritten with only 4 AG X entries
+- Restored: Command Code, Crof.ai, OpenAdapter, OpenAdapter GO Plan, OpenCode Zen (OpenAI + Anthropic), OpenCode Go (OpenAI + Anthropic), OpenRouter, NVIDIA NIM, Z.ai Coding, Google Gemini (API Key + OAuth), Google Antigravity (OAuth), Anthropic, OpenAI, Cobra (chats-llm.com)
+
+### GUI Changes
+- New preset: **"Freebuff (Free DeepSeek/Kimi)"** in provider dropdown
+- New backend type: **"Freebuff - Free DeepSeek/Kimi"** in type selector
+- Version label updated to v3.8.1
+- Changelog entry for v3.8.1 added
+
+### Stats
+- translate-proxy.py: +205 lines (freebuff backend)
+- codex-launcher-gui: +19 lines (preset + changelog)
+- .deb size: 84KB
+- Self-tests: 54/54 passing
+
+---
+
 ## v3.8.0 (2026-05-22)
 
 **AI Monitoring — Self-Healing Watchdog with 3-Tier Response System**

README.md

@@ -544,13 +544,27 @@ The launcher generates model catalog JSON with dual field naming to satisfy both
 | OpenCode Zen | OpenAI-compat | `https://opencode.ai/zen/v1` |
 | OpenCode Go | OpenAI-compat | `https://opencode.ai/zen/go/v1` |
 | Command Code | Command Code | `https://api.commandcode.ai` |
+| **Freebuff** | **Freebuff** | `https://freebuff.com` *(free DeepSeek/Kimi)* |
 | Crof.ai | OpenAI-compat | `https://crof.ai/v1` |
+| OpenAdapter | OpenAI-compat | `https://api.openadapter.in/v1` |
 | NVIDIA NIM | OpenAI-compat | `https://integrate.api.nvidia.com/v1` |
 | Kilo.ai | OpenAI-compat | `https://api.kilo.ai/api/gateway` |
 | OpenRouter | OpenAI-compat | `https://openrouter.ai/api/v1` |
 | Z.AI | OpenAI-compat | `https://api.z.ai/api/coding/paas/v4` |
+| Google Gemini (API Key) | OpenAI-compat | `https://generativelanguage.googleapis.com/v1beta/openai` |
+| Google Gemini (OAuth) | Gemini OAuth | `cloudcode-pa.googleapis.com` |
+| Google Antigravity (OAuth) | Antigravity OAuth | `daily-cloudcode-pa.sandbox.googleapis.com` |
 | Custom | Any | User-defined |
 
+### Free Models (via Freebuff)
+Freebuff provides free access to these models — no API key needed:
+- **DeepSeek V4 Pro** — Smartest model
+- **DeepSeek V4 Flash** — Most efficient
+- **Kimi K2.6** — Balanced
+- **MiniMax M2.7** — Fastest
+
+*Requires: `npm install -g freebuff && freebuff login` (GitHub OAuth)*
+
 ---
 
 ## File Structure
@@ -581,6 +595,51 @@ README.md                         # This file
 
 ---
 
+### Phase 10: Freebuff Integration — Free AI for Everyone (v3.8.1)
+
+**Problem:** Users want access to powerful models like DeepSeek V4 Pro without paying API fees. Freebuff (by CodebuffAI) offers free access to premium models through their server, but it's a CLI tool — not an API you can plug into Codex Launcher.
+
+**The insight:** Freebuff's backend is a Next.js app with an OpenAI-compatible `/api/v1/chat/completions` endpoint. It uses agent-run lifecycle management and model-specific routing. If we replicate the agent run protocol in our proxy, we can tap into freebuff's free tier.
+
+**How Freebuff works internally:**
+1. User logs in via GitHub OAuth → session token stored in `~/.config/manicode/credentials.json`
+2. Each request creates an **agent run** via `POST /api/v1/agent-runs`
+3. Chat completions sent with `codebuff_metadata: {run_id, cost_mode: "free"}`
+4. Server routes to the correct upstream provider using its own API keys
+5. Agent run finished when request completes
+
+**What we built:**
+
+```
+Codex Request
+     │
+     ▼
+┌─────────────────────────────────┐
+│  translate-proxy.py              │
+│  _handle_freebuff()             │
+│                                  │
+│  1. Read token from credentials  │
+│  2. POST /api/v1/agent-runs      │──→  {action: "START", agentId}
+│  3. POST /api/v1/chat/completions │──→  {model, messages,
+│                                        codebuff_metadata: {
+│                                          run_id, cost_mode: "free"}}
+│  4. Stream response back to Codex   │←──  SSE events
+│  5. POST /api/v1/agent-runs       │──→  {action: "FINISH"}
+└─────────────────────────────────┘
+```
+
+**Free models available:**
+| Model | Agent ID | Notes |
+|-------|----------|-------|
+| DeepSeek V4 Pro | `base2-free-deepseek` | Smartest |
+| DeepSeek V4 Flash | `base2-free-deepseek-flash` | Most efficient |
+| Kimi K2.6 | `base2-free-kimi` | Balanced |
+| MiniMax M2.7 | `base2-free` | Fastest |
+
+**Bonus fix:** While investigating this, we discovered that `endpoints.json` had been overwritten with only 4 AG X entries, losing all 17+ provider presets. Restored all presets from proxy cache files.
+
+---
+
 ## Troubleshooting
 
 | Issue | Cause | Fix |