familiar-vtt 2.8.0 → 2.10.0

package/README.md

@@ -143,7 +143,7 @@ Build NPCs, manage party inventory, apply buffs, and clone monsters from any com
 
 **$3/month** with a **free 1-month trial** so you can try everything before you commit. All features are available during the trial, no restrictions.
 
-Familiar itself costs $3/month. AI provider costs are separate and depend on your usage and chosen provider. A typical D&D session runs roughly **$0.50–$3** in API costs depending on the model, or **$0** if you use a subscription (Claude, ChatGPT/Codex, Gemini) through MCP or local models through Ollama.
+Familiar itself costs $3/month. AI provider costs are separate and depend on your usage and chosen provider. A typical D&D session runs roughly **$0.50–$3** in API costs depending on the model, or **$0** if you use a subscription (Claude, ChatGPT/Codex, Antigravity/Gemini) through MCP or local models through Ollama.
 
 ### Your keys, your cost
 
@@ -155,7 +155,7 @@ Familiar works differently. You bring your own AI, whether that's an API key you
 
 Install the Foundry module, pick a provider, and start talking to your game.
 
-If you want to connect an MCP client (Claude Desktop, Claude Code, Codex CLI, Gemini CLI, or ChatGPT), you also need the MCP server:
+If you want to connect an MCP client (Claude Desktop, Claude Code, Codex CLI / Desktop, Antigravity CLI / Editor, Gemini CLI, or ChatGPT), you also need the MCP server:
 
 ```sh
 npx familiar-vtt
@@ -193,26 +193,31 @@ This is the right choice if you want the simplest setup, or if you want voice, i
 
 ### Option 2: MCP (your existing subscription)
 
-Already paying for Claude, ChatGPT/Codex, or Gemini? Put that subscription to work. Connect it directly to Familiar through the [Model Context Protocol](https://modelcontextprotocol.io). Your subscription becomes a DM assistant at no extra API cost.
+Already paying for Claude, ChatGPT/Codex, Gemini, or have a Google account for Antigravity? Put that subscription to work. Connect it directly to Familiar through the [Model Context Protocol](https://modelcontextprotocol.io). Your subscription becomes a DM assistant at no extra API cost.
 
-Familiar supports five MCP clients out of the box:
+Familiar supports eight MCP clients out of the box:
 
-| Client | Transport | Setup |
-|--------|-----------|-------|
-| Claude Desktop | stdio | Add to `claude_desktop_config.json` |
-| Claude Code (CLI) | stdio | `claude mcp add familiar -- npx familiar-vtt` |
-| Codex CLI | stdio | `codex mcp add familiar -- npx -y familiar-vtt` |
-| Gemini CLI | stdio | Add to MCP settings |
-| ChatGPT | Streamable HTTP | Remote URL via Cloudflare tunnel |
+| Client | Subscription | Transport | Setup |
+|--------|-------------|-----------|-------|
+| Claude Desktop | Anthropic Pro / Max / Team | stdio | Add to `claude_desktop_config.json` with `env: { FAMILIAR_WS_SECRET }` |
+| Claude Code (CLI) | Anthropic Pro / Max / Team | stdio | `claude mcp add --env FAMILIAR_WS_SECRET=… familiar -- npx familiar-vtt` |
+| Codex CLI | ChatGPT Plus / Pro / Team | stdio | `codex mcp add familiar --env FAMILIAR_WS_SECRET=… -- npx -y familiar-vtt` |
+| Codex Desktop | ChatGPT Plus / Pro / Team | stdio | Add `[mcp_servers.familiar]` block to `~/.codex/config.toml` (shared with CLI / IDE) |
+| Antigravity CLI (`agy`) | Google free / Pro / Ultra | stdio | Generates `~/.gemini/config/mcp_config.json`; sign in via `agy` → Google OAuth |
+| Antigravity Editor | Google free / Pro / Ultra | stdio | Add to `~/.gemini/antigravity/mcp_config.json` (desktop IDE; separate install from CLI) |
+| Gemini CLI ¹ | Google | stdio | Add to MCP settings with the `env` block |
+| ChatGPT | ChatGPT Plus / Pro / Team | Streamable HTTP | Remote URL via Cloudflare tunnel |
 
-You don't need to configure each client by hand. The **MCP Setup Wizard** in Module Settings → Familiar detects your connected client and generates the exact config. Copy and paste.
+¹ *Gemini CLI is deprecated by Google on 2026-06-18 — use Antigravity CLI instead.*
+
+You don't need to configure each client by hand. The **MCP Setup Wizard** in Module Settings → Familiar detects your connected client and generates the exact config — including the auto-generated `FAMILIAR_WS_SECRET` baked in. Copy and paste.
 
 ### Which should I pick?
 
 | I want to... | Use |
 |--------------|-----|
 | Get started in under a minute | **Built-in chat** with any API key |
-| Use my Claude/ChatGPT/Codex/Gemini subscription | **MCP** |
+| Use my Claude / ChatGPT / Codex / Gemini / Antigravity subscription | **MCP** |
 | Run everything offline | **Built-in chat** with Ollama or LM Studio |
 | Have voice, images, and transcription | **Built-in chat** (MCP is text-only) |
 | Run complex multi-step tasks | **MCP** (external clients handle long chains better) |
@@ -268,7 +273,7 @@ Built-in chat works anywhere Foundry runs, including The Forge. The module makes
 <details>
 <summary><b>What's the difference between MCP mode and built-in chat?</b></summary>
 
-Built-in chat runs inside Foundry with no extra server. The fastest way to start. MCP connects Familiar to external clients (Claude Desktop, Codex CLI, ChatGPT, Gemini) through a local server, letting you use existing subscriptions and handling complex multi-step tasks better. Both have access to the same 188 tools.
+Built-in chat runs inside Foundry with no extra server. The fastest way to start. MCP connects Familiar to external clients (Claude Desktop, Codex CLI / Desktop, Antigravity CLI / Editor, ChatGPT, Gemini) through a local server, letting you use existing subscriptions and handling complex multi-step tasks better. Both have access to the same 188 tools.
 
 </details>