chesspal 0.4.1 → 0.5.0

package/README.md

@@ -6,18 +6,32 @@ Play chess against an AI on a real board, or learn with one.
 
 ## Get started
 
-Five steps, done once, in about 15 minutes. You need a paid Claude plan or a ChatGPT account. After these steps you open the board with a double click.
+Five steps, done once, in about 15 minutes. You need a paid Claude plan, a ChatGPT account or a Google account. After these steps you open the board with a double click.
 
-**1. Install Node.js.** Download it from [nodejs.org](https://nodejs.org): take the version marked **LTS**, the steady one (22.13 or newer). Install it like any program, keeping every choice as it is; on Windows, leave the box "Automatically install the necessary tools" unticked.
+**1. Install Node.js.** Chesspal needs **Node.js 22.13 or newer**, which comes with **npm 10.9.2 or newer**.
+
+- **Windows and macOS:** download it from [nodejs.org](https://nodejs.org): take the version marked **LTS**, the steady one. Install it like any program, keeping every choice as it is; on Windows, leave the box "Automatically install the necessary tools" unticked.
+- **Linux:** do not take the Node.js of your system's programs (`apt`): it is often older, and it asks for `sudo` to install Chesspal. Install it with nvm, which puts it in your home folder. Open a terminal (step 2) and run:
+
+  ```bash
+  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash
+  ```
+
+  Close the terminal, open a new one, and run:
+
+  ```bash
+  nvm install 22
+  ```
 
 **2. Open a terminal**, the window where you type commands. Open it after installing Node.js: one opened before does not find it.
 
 - **Windows:** press Start, type `cmd` and press Enter. This opens Command Prompt. Use it rather than PowerShell: on a new computer PowerShell refuses these commands with "running scripts is disabled on this system".
 - **macOS:** press ⌘ and Space, type `Terminal` and press Enter.
+- **Linux:** press Ctrl+Alt+T, or look for "Terminal" among your programs.
 
 In the steps below, copy each command, paste it in the terminal (Ctrl+V or right-click; on macOS ⌘V) and press Enter. Wait for the terminal to finish before the next one. Lines with "WARN" are normal: go on.
 
-**3. Install the AI and sign in.** Choose one of the two. You need your own subscription: Chesspal never uses an API key, which is paid by the call.
+**3. Install the AI and sign in.** Choose one of the three. You need your own subscription: Chesspal never uses an API key, which is paid by the call.
 
 - **Claude Code**, with a paid Claude plan (Pro or higher; the free plan does not include it):
 
@@ -35,6 +49,19 @@ In the steps below, copy each command, paste it in the terminal (Ctrl+V or right
   ```
 
   Choose **Sign in with ChatGPT** and sign in in your browser.
+- **Antigravity**, Google's, with a Google account (the free plan is enough: Chesspal plays with Gemini Flash). On Windows, in Command Prompt:
+
+  ```bash
+  curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
+  ```
+
+  On macOS and Linux:
+
+  ```bash
+  curl -fsSL https://antigravity.google/cli/install.sh | bash
+  ```
+
+  Then close the terminal, open a new one, run `agy` and sign in with your Google account.
 
 Once you are signed in, close that terminal window with its × and open a new one, as in step 2.
 
@@ -47,7 +74,7 @@ chesspal
 
 The board page opens in your browser, and you can close this terminal. The first time, Chesspal offers an icon on your desktop and in your menu of programs: accept it, and from then on you open the board with a double click on it, with no terminal.
 
-**5. Start the AI.** The first time, the board page asks who you are: fill it in and press **Start playing**. Then press **Claude Code** or **Codex**: the AI opens in a terminal of its own. Keep that window open while you play. The first time it asks some questions:
+**5. Start the AI.** The first time, the board page asks who you are: fill it in and press **Start playing**. Then press **Claude Code**, **Codex** or **Antigravity**: the AI opens in a terminal of its own. Keep that window open while you play. The first time it asks some questions:
 
 - whether you trust the folder: choose **Yes** with the arrow keys and press Enter;
 - with Codex, about Chesspal's two hooks, the small programs that tell the AI when you move on the board: choose **Trust all and continue**;
@@ -58,7 +85,9 @@ Now press **New game**: choose your colour, the clock and the AI's level, and pl
 **If a command fails:**
 
 - "npm is not recognized" or "command not found": close the terminal and open a new one; if it still fails, install Node.js again.
+- "Unsupported engine", or `node --version` says less than 22.13: your Node.js is too old. Install it again as in step 1.
 - On macOS, "EACCES" or "permission denied": npm cannot write where Node.js put it. Follow [npm's guide](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally), not `sudo`: with `sudo`, Chesspal and Claude Code cannot update themselves.
+- On Linux, "EACCES" or "permission denied": npm cannot write where your system's Node.js is. Do not use `sudo`: install Node.js with nvm, as in step 1, then run `npm install -g chesspal` again.
 - Anything else in red, or with "ERR!": copy the last lines and [tell us](#try-it-and-tell-us).
 
 ## What it does
@@ -75,16 +104,16 @@ Coming later: an AI coach that helps you grow, exercises chosen on your weak poi
 
 ## What you need
 
-- **Node.js 22.13** or newer.
-- **An AI agent** with your own subscription: [Claude Code](https://code.claude.com/docs/en/setup), with a paid Claude plan, or [Codex](https://developers.openai.com/codex), with a ChatGPT account.
+- **Node.js 22.13** or newer, with **npm 10.9.2** or newer, which comes with it.
+- **An AI agent** with your own subscription: [Claude Code](https://code.claude.com/docs/en/setup), with a paid Claude plan, [Codex](https://developers.openai.com/codex), with a ChatGPT account, or [Antigravity](https://antigravity.google/docs/getting-started), with a Google account.
 - **A web browser**, for the board page.
 
-Chesspal works with any agent that can use Chesspal's tools (MCP) and the files on your computer: we develop it with Claude Code, and Codex is connected too.
+Chesspal works with any agent that can use Chesspal's tools (MCP) and the files on your computer: we develop it with Claude Code, and Codex and Antigravity are connected too.
 
 ## Good to know
 
 - **For the next game**, press New game: the AI the board page opened starts again with a clean chat by itself, once it has stopped working. In a chat you opened yourself, type `/clear` first: a long chat makes the AI slower and costs you more.
-- **To play in a folder of your own**, as with the Claude desktop app, type `chesspal init chess`, then open your agent in the folder `chess` and say hello: the AI answers with the link to the board page. Any name will do; your games are kept [elsewhere](#where-your-games-are).
+- **To play in a folder of your own**, as with the Claude desktop app, type `chesspal init chess`, then open your agent in the folder `chess` and say hello: the AI answers with the link to the board page. Any name will do; your games are kept [elsewhere](#where-your-games-are). Antigravity opened there asks about each of Chesspal's tools the first time: choose to always allow it (Persist to settings.json). Its very first chat in a new folder does not notice your moves on the board: type `/clear` once before you play.
 - **A move written in the chat** counts too: `e4`, `Nf3`, in the international notation (K Q R B N in every language), or in words.
 - **To update**, when a new version is out the table's page shows an arrow at the top: press it between games, and the table installs it and starts again, with its chat. By hand: close the AI's terminal, run `npm install -g chesspal` again, then `chesspal`. In a folder of your own, run `chesspal init` there too: it updates its own lines and keeps what you wrote there. In Codex, allow the hooks again when it says so.
 - **To uninstall**, run `chesspal icon --remove` first, which takes the icon off your desktop and menu, then `npm uninstall -g chesspal`. Your games stay [where they are](#where-your-games-are).

package/dist/cli/chat-hook.d.ts

@@ -1,2 +1,5 @@
-/** Reads the hook's input and writes how the chat started; a failure is told on stderr and never stops the chat. */
+/**
+ * Reads the hook's input and writes how the chat started; a failure is told on stderr and never stops the chat. Antigravity names its chat a conversation,
+ * new at every start, /clear too, and runs the hook in .agents: the chat's folder is the one its input names.
+ */
 export declare function recordChatStart(input?: NodeJS.ReadableStream, folder?: string, now?: Date): Promise<void>;

package/dist/cli/chat-hook.js

@@ -1,14 +1,21 @@
-// `chesspal chat`, the SessionStart hook of Claude Code and Codex (D-57): it writes how the chat started, new, cleared, resumed or compacted, for new_game to read.
+// `chesspal chat`, the SessionStart hook of Claude Code, Codex and Antigravity (D-57): it writes how the chat started, new, cleared, resumed or compacted,
+// for new_game to read.
 import { saveChatStart } from "../games/index.js";
-/** Reads the hook's input and writes how the chat started; a failure is told on stderr and never stops the chat. */
+/**
+ * Reads the hook's input and writes how the chat started; a failure is told on stderr and never stops the chat. Antigravity names its chat a conversation,
+ * new at every start, /clear too, and runs the hook in .agents: the chat's folder is the one its input names.
+ */
 export async function recordChatStart(input = process.stdin, folder = process.cwd(), now = new Date()) {
     try {
         const hook = parsed(await textOf(input));
-        saveChatStart(folder, {
+        const conversation = typeof hook.conversationId === "string" ? hook.conversationId : undefined;
+        const session = typeof hook.session_id === "string" ? hook.session_id : conversation;
+        const transcript = typeof hook.transcript_path === "string" ? hook.transcript_path : typeof hook.transcriptPath === "string" ? hook.transcriptPath : undefined;
+        saveChatStart(conversation !== undefined && typeof hook.cwd === "string" ? hook.cwd : folder, {
             source: typeof hook.source === "string" ? hook.source : "startup",
             at: now.toISOString(),
-            ...(typeof hook.session_id === "string" ? { session: hook.session_id } : {}),
-            ...(typeof hook.transcript_path === "string" ? { transcript: hook.transcript_path } : {}),
+            ...(session === undefined ? {} : { session }),
+            ...(transcript === undefined ? {} : { transcript }),
         });
     }
     catch (error) {

package/dist/cli/cli.js

@@ -31,9 +31,9 @@ else if (args.length === 1 && args[0] === "mcp") {
     const { startMcpServer } = await import("../server/mcp/index.js");
     await startMcpServer();
 }
-else if (args[0] === "listen" && (args.length === 1 || (args.length === 2 && args[1] === "--codex"))) {
+else if (args[0] === "listen" && (args.length === 1 || (args.length === 2 && (args[1] === "--codex" || args[1] === "--antigravity")))) {
     const { listen } = await import("../server/bell/index.js");
-    await listen(args[1] === "--codex");
+    await listen(args[1] === "--codex" ? "codex" : args[1] === "--antigravity" ? "antigravity" : "claude");
 }
 else if (args.length === 1 && args[0] === "chat") {
     const { recordChatStart } = await import("./chat-hook.js");
@@ -92,7 +92,7 @@ async function putIconHere() {
 async function playHere(host) {
     const [{ isHostName, playHost }, { defaultContext }] = await Promise.all([import("../server/table/index.js"), import("../commands/index.js")]);
     if (!isHostName(host)) {
-        console.error(`chesspal play takes claude or codex, not ${host}.`);
+        console.error(`chesspal play takes claude, codex or antigravity, not ${host}.`);
         process.exitCode = 1;
         return;
     }

package/dist/cli/command-line.js

@@ -6,15 +6,15 @@ import { version } from "../version.js";
 // The commands that exist only on the command line: cli.ts starts the table, opens its page, puts its icon, starts the server, the doorbell, the chat's
 // note or the move written alone, when one comes alone.
 const mcpDescription = "Start the MCP server for an AI host. Through it the host uses these commands as tools; the host starts it, with no options.";
-const listenDescription = "Wait for the player's move on the board page and wake the chat. Claude Code starts it at the end of each turn, and Codex with --codex, as init sets them up.";
-const chatDescription = "Note how the chat started: new, cleared, resumed or compacted. Claude Code and Codex run it when a chat starts, as init sets them up.";
+const listenDescription = "Wait for the player's move on the board page and wake the chat. Claude Code starts it at the end of each turn, Codex with --codex and Antigravity with --antigravity, as init sets them up.";
+const chatDescription = "Note how the chat started: new, cleared, resumed or compacted. Claude Code, Codex and Antigravity run it when a chat starts, as init sets them up.";
 const promptDescription = "Play the move the player wrote alone in the chat, before the AI reads it, and tell the AI the position. Claude Code runs it on each message, as init sets it up.";
 const tableDescription = "Serve the board page with no chat, until no browser has had it open for five minutes. `chesspal` alone starts it apart and opens the page.";
 const openDescription = "Open the board page as `chesspal` alone does, without asking about the icon: what the icon runs.";
 const iconDescription = "Put Chesspal's icon on the desktop and in the menu: it opens the board page as `chesspal` alone does, with no terminal. `chesspal icon --remove` takes it away.";
-const playDescription = "Start the AI in this terminal, in Claude Code or Codex, as the page's buttons do. It plays with the model and effort chosen on the page; New game there starts the chat again, clean.";
+const playDescription = "Start the AI in this terminal, in Claude Code, Codex or Antigravity, as the page's buttons do. It plays with the model and effort chosen on the page; New game there starts the chat again, clean.";
 // What init and the icon's removal are to a player, in the general help: the command's own help says the files.
-const initForPlayer = "Set up a folder of your own to play in, from Claude Code, Codex or the Claude desktop app.";
+const initForPlayer = "Set up a folder of your own to play in, from Claude Code, Codex, Antigravity or the Claude desktop app.";
 const iconRemoveForPlayer = "Take Chesspal's icon away, before you uninstall it.";
 // Those of them that take no options, by name.
 const plainCommands = new Map([["mcp", mcpDescription], ["chat", chatDescription], ["prompt", promptDescription], ["table", tableDescription], ["open", openDescription], ["icon", iconDescription]]);
@@ -34,14 +34,14 @@ export async function runCommandLine(argv, context = defaultContext(), list = co
         return args.length === 0 || args.includes("--help") || args.includes("-h") ? success(help) : failure(`chesspal ${commandName} takes no options: ${args.join(" ")}.\n\n${help}`);
     }
     if (commandName === "listen") {
-        const help = `chesspal listen [--codex]\n\n${listenDescription}`;
-        const known = args.every((arg) => ["--codex", "--help", "-h"].includes(arg));
-        return known ? success(help) : failure(`chesspal listen takes only --codex: ${args.join(" ")}.\n\n${help}`);
+        const help = `chesspal listen [--codex|--antigravity]\n\n${listenDescription}`;
+        const known = args.every((arg) => ["--codex", "--antigravity", "--help", "-h"].includes(arg));
+        return known ? success(help) : failure(`chesspal listen takes only --codex or --antigravity: ${args.join(" ")}.\n\n${help}`);
     }
     if (commandName === "play") {
         // cli.ts runs `chesspal play <host>`; here come the help and what it refuses.
-        const help = `chesspal play <claude|codex>\n\n${playDescription}`;
-        return args.includes("--help") || args.includes("-h") ? success(help) : failure(`chesspal play takes one host, claude or codex: ${args.join(" ") || "none given"}.\n\n${help}`);
+        const help = `chesspal play <claude|codex|antigravity>\n\n${playDescription}`;
+        return args.includes("--help") || args.includes("-h") ? success(help) : failure(`chesspal play takes one host, claude, codex or antigravity: ${args.join(" ") || "none given"}.\n\n${help}`);
     }
     const command = list.find((candidate) => candidate.name === commandName);
     if (!command) {

package/dist/commands/game/new.js

@@ -3,7 +3,7 @@ import { join } from "node:path";
 import { z } from "zod";
 import { aiLevels, Game, levelTag, pgnDate, readPgn, startClock, timeControlOf, timeControlTag, withoutMoods } from "../../core/index.js";
 import { archivedName, archiveGame, archiveName, cleanSince, endAnalysis, endOf, endTableTalk, lastChatStart, loadGame, saveGame, startOfNewGame, withoutPlans } from "../../games/index.js";
-import { hasDoorbell } from "../../host-files/index.js";
+import { hasDoorbell, hookedHosts } from "../../host-files/index.js";
 import { gameFolder, gameFolders } from "../../profiles/index.js";
 import { coachRuns, gameAt, nextStep, openingTags, positionLines, refuseUnseenPosition, sidesLine, speechLine, speechOf, summaryOf, withThought } from "../answers/index.js";
 import { pastGameLines, playerLine } from "../profiles/index.js";
@@ -159,18 +159,16 @@ export const pliesBeforeClearing = 20;
 const fenPattern = /^[pnbrqkPNBRQK1-8]+(?:\/[pnbrqkPNBRQK1-8]+){7}(?:\s|$)/;
 /**
  * Whether the chat must be cleared first: the last game begun, in any profile, was played in it at some length, and the host says how chats start (the hook
- * of Claude Code and Codex). Another profile does not clear the chat (D-66), nor a game another chat played, which this one was never shown (D-71).
+ * of Claude Code, Codex and Antigravity). Another profile does not clear the chat (D-66), nor a game another chat played, which this one was never shown (D-71).
  */
 function chatToClear(context) {
     const start = lastChatStart(context.folder);
-    if (!hostsNotingChats.has(context.host?.() ?? "") || start === undefined) {
+    if (!hookedHosts.includes(context.host?.() ?? "") || start === undefined) {
         return false;
     }
     const last = gameFolders(context.home()).flatMap((folder) => loadGame(folder) ?? []).sort((one, other) => Date.parse(other.started) - Date.parse(one.started))[0];
     return last !== undefined && last.started === context.positionSeen?.started && last.game.record.moves.length >= pliesBeforeClearing && !cleanSince(start, last.started);
 }
-// The hosts whose SessionStart hook, written by init, notes how each chat starts: Claude Code and Codex, by the names they give the server.
-const hostsNotingChats = new Set(["claude-code", "codex-mcp-client"]);
 /**
  * Writes the new game over the one before, archived first: both under game.json's lock, on the game before as read, so a game another process changed
  * since is neither archived stale nor lost. When game.json cannot be written, an archive this call made goes: nothing changed.

package/dist/commands/registry/context.d.ts

@@ -12,6 +12,11 @@ export interface Context {
     pause?: (milliseconds: number) => Promise<void>;
     /** The operating system, as process.platform names it: how a host starts the server. */
     platform: string;
+    /**
+     * The home folder of the computer's user, where a host keeps the settings of all its folders: init adds Chesspal's server to Antigravity's there
+     * (D-115). None in the tests, which never write there.
+     */
+    userHome?: () => string;
     /** The player's language, as the system names it (it-IT): the command line's words to the player, in English when none or another. */
     language?: string;
     /** The address of the board page, when the MCP server serves it (D-47). */

package/dist/commands/registry/context.js

@@ -1,5 +1,5 @@
 // What every command runs with besides its input, injected by the command line, the MCP server or the tests: the folders, the time, the randomness.
-import { userInfo } from "node:os";
+import { homedir, userInfo } from "node:os";
 import { dataFolder, openFolder } from "../../home/index.js";
 import { ensureProfile } from "../../profiles/index.js";
 /** The context of a process started in the player's folder: the data folder is found at the first command that needs it, once. */
@@ -12,6 +12,7 @@ export function defaultContext() {
         random: Math.random,
         now: () => new Date(),
         platform: process.platform,
+        userHome: homedir,
         language: systemLanguage(),
         given: new Set(),
         openFolder: (folder) => openFolder(folder, process.platform),

package/dist/commands/setup/init.d.ts

@@ -8,7 +8,10 @@ interface FolderSetUp {
     /** Codex's hooks changed in a folder that had them: Codex runs them only once the player trusts them again. */
     hooksChanged?: true;
 }
-/** Makes a folder the player's chess table: the files through which Claude Code and Codex find Chesspal and the opponent's instructions (D-31). */
+/**
+ * Makes a folder the player's chess table: the files through which Claude Code, Codex and Antigravity find Chesspal and the opponent's instructions
+ * (D-31, D-115), and Antigravity's settings for every folder, where it is installed.
+ */
 export declare const init: import("../registry/registry.ts").Command<z.ZodObject<{
     folder: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, FolderSetUp>;

package/dist/commands/setup/init.js

@@ -1,15 +1,18 @@
 import { existsSync } from "node:fs";
-import { relative, resolve } from "node:path";
+import { isAbsolute, relative, resolve } from "node:path";
 // Colours only on a terminal that shows them: none in a file, a pipe or with NO_COLOR.
 import { styleText } from "node:util";
 import { z } from "zod";
 import { codexHooksPath, setUpHosts } from "../../host-files/index.js";
 import { defineCommand, speaksItalian } from "../registry/index.js";
-/** Makes a folder the player's chess table: the files through which Claude Code and Codex find Chesspal and the opponent's instructions (D-31). */
+/**
+ * Makes a folder the player's chess table: the files through which Claude Code, Codex and Antigravity find Chesspal and the opponent's instructions
+ * (D-31, D-115), and Antigravity's settings for every folder, where it is installed.
+ */
 export const init = defineCommand({
     name: "init",
-    description: "Sets up a folder to play chess with an AI: the .mcp.json, AGENTS.md, CLAUDE.md and the settings through which Claude Code and Codex find "
-        + "Chesspal. Run it again to update Chesspal's lines; what you wrote there stays. Example: chesspal init chess.",
+    description: "Sets up a folder to play chess with an AI: the .mcp.json, AGENTS.md, CLAUDE.md and the settings through which Claude Code, Codex and "
+        + "Antigravity find Chesspal. Run it again to update Chesspal's lines; what you wrote there stays. Example: chesspal init chess.",
     input: z.object({ folder: z.string().optional().describe("the folder to set up; the current folder if left out") }),
     cliOnly: true,
     idempotent: true,
@@ -18,11 +21,11 @@ export const init = defineCommand({
         const root = resolve(context.folder, folder ?? ".");
         const hooks = codexHooksPath(root);
         const hadHooks = existsSync(hooks);
-        const written = setUpHosts(root, context.platform);
+        const written = setUpHosts(root, context.platform, context.userHome?.());
         const enter = relative(context.folder, root);
         return {
             folder: root,
-            written: written.map((path) => relative(root, path)),
+            written: written.map((path) => inFolder(root, path)),
             ...(enter === "" ? {} : { enter }),
             ...(hadHooks && written.includes(hooks) ? { hooksChanged: true } : {}),
         };
@@ -44,9 +47,15 @@ const english = {
     set: (folder) => `Chesspal is ready in ${folder}`,
     ready: (folder) => `Chesspal is ready in ${folder}: nothing to change`,
     toPlay: "To play:",
-    open: (enter) => enter === undefined ? ["Open Claude Code or Codex in this folder."] : [`Go into the folder: cd ${enter}`, "then open Claude Code (claude) or Codex (codex)."],
+    open: (enter) => enter === undefined ? ["Open Claude Code, Codex or Antigravity in this folder."] : [`Go into the folder: cd ${enter}`, "then open Claude Code (claude), Codex (codex) or Antigravity (agy)."],
     steps: [
-        ["The first time, it asks whether to trust the folder: say yes.", "Codex also asks about Chesspal's two hooks: choose Trust all.", "They are small helpers that let it notice your moves on the board."],
+        [
+            "The first time, it asks whether to trust the folder: say yes.",
+            "Codex also asks about Chesspal's two hooks: choose Trust all.",
+            "They are small helpers that let it notice your moves on the board.",
+            "Antigravity asks about each of Chesspal's tools the first time:",
+            "choose to always allow it (Persist to settings.json).",
+        ],
         ["Say hello: the AI gives you the link to the board."],
     ],
     hooksChanged: "Chesspal's hooks for Codex have changed: when Codex asks about them, choose Trust all again.",
@@ -56,14 +65,25 @@ const italian = {
     set: (folder) => `Chesspal è pronto in ${folder}`,
     ready: (folder) => `Chesspal è già pronto in ${folder}: niente da cambiare`,
     toPlay: "Per giocare:",
-    open: (enter) => enter === undefined ? ["Apri Claude Code o Codex in questa cartella."] : [`Entra nella cartella: cd ${enter}`, "poi apri Claude Code (claude) o Codex (codex)."],
+    open: (enter) => enter === undefined ? ["Apri Claude Code, Codex o Antigravity in questa cartella."] : [`Entra nella cartella: cd ${enter}`, "poi apri Claude Code (claude), Codex (codex) o Antigravity (agy)."],
     steps: [
-        ["La prima volta ti chiede se fidarti della cartella: rispondi sì.", "Codex chiede anche dei due «hook» di Chesspal: scegli Trust all.", "Sono piccoli aiuti che gli fanno vedere le tue mosse sulla scacchiera."],
+        [
+            "La prima volta ti chiede se fidarti della cartella: rispondi sì.",
+            "Codex chiede anche dei due «hook» di Chesspal: scegli Trust all.",
+            "Sono piccoli aiuti che gli fanno vedere le tue mosse sulla scacchiera.",
+            "Antigravity chiede di ogni strumento di Chesspal, la prima volta:",
+            "scegli di consentirlo sempre (Persist to settings.json).",
+        ],
         ["Saluta: l'AI ti dà il link della scacchiera."],
     ],
     hooksChanged: "Gli «hook» di Chesspal per Codex sono cambiati: quando Codex te lo chiede, scegli di nuovo Trust all.",
     updated: (count) => count === 1 ? "Aggiornato 1 file." : `Aggiornati ${count} file.`,
 };
+/** A file init wrote, by its path in the player's folder; one outside it, as Antigravity's settings in the user's home, by its whole path. */
+function inFolder(folder, path) {
+    const inside = relative(folder, path);
+    return inside.startsWith("..") || isAbsolute(inside) ? path : inside;
+}
 /** A path as a shell reads it as one word: in quotes when it has spaces. */
 function quoted(path) {
     return /\s/.test(path) ? `"${path}"` : path;

package/dist/core/review.d.ts

@@ -82,8 +82,8 @@ export declare function withAiHost(record: GameRecord, host: string | undefined)
 /** The host the AI played the game in, as its tags say (D-97); undefined without one. */
 export declare function aiHostIn(record: GameRecord): string | undefined;
 /**
- * The AI's name from its host: Claude Code and the desktop app are Claude, Codex is Codex; without a host it names, from the model, a Claude model is
- * Claude (D-97). Undefined otherwise.
+ * The AI's name from its host: Claude Code and the desktop app are Claude, Codex is Codex, Antigravity is Gemini, unless its model is known to be another
+ * (D-97, D-115); without a host it names, from the model, a Claude model is Claude. Undefined otherwise.
  */
 export declare function aiNameOf(host: string | undefined, model?: string): string | undefined;
 /** The record with the AI's word on the whole game, or its last word on the ending, in place of the one it had: each only when given. */

package/dist/core/review.js

@@ -108,17 +108,21 @@ export function aiHostIn(record) {
     return host === undefined || host === "" ? undefined : host;
 }
 /**
- * The AI's name from its host: Claude Code and the desktop app are Claude, Codex is Codex; without a host it names, from the model, a Claude model is
- * Claude (D-97). Undefined otherwise.
+ * The AI's name from its host: Claude Code and the desktop app are Claude, Codex is Codex, Antigravity is Gemini, unless its model is known to be another
+ * (D-97, D-115); without a host it names, from the model, a Claude model is Claude. Undefined otherwise.
  */
 export function aiNameOf(host, model) {
+    const named = model?.trim() ?? "";
     if (/claude/i.test(host ?? "")) {
         return "Claude";
     }
     if (/codex/i.test(host ?? "")) {
         return "Codex";
     }
-    return /^claude/i.test(model?.trim() ?? "") ? "Claude" : undefined;
+    if (/antigravity/i.test(host ?? "")) {
+        return named === "" || /^gemini/i.test(named) ? "Gemini" : /^claude/i.test(named) ? "Claude" : "Antigravity";
+    }
+    return /^claude/i.test(named) ? "Claude" : undefined;
 }
 /** The record with the AI's word on the whole game, or its last word on the ending, in place of the one it had: each only when given. */
 export function withGameReview(record, { summary, closing }) {

package/dist/host-files/host-files.d.ts

@@ -1,9 +1,10 @@
 /**
- * Sets up the player's folder for Claude Code and Codex (D-31): .mcp.json with the chesspal server, AGENTS.md with the lines that start a chat between
- * Chesspal's marks (D-102), CLAUDE.md importing it, the hosts' settings with the server approved, and their hooks. What the player wrote there stays; it returns
- * the files written.
+ * Sets up the player's folder for Claude Code, Codex and Antigravity (D-31, D-115): .mcp.json with the chesspal server, AGENTS.md with the lines that start
+ * a chat between Chesspal's marks (D-102), CLAUDE.md importing it, the hosts' settings with the server approved, and their hooks. With the user's home
+ * given, where Antigravity is installed, the chesspal server in its settings for every folder too, which alone give the first chat its tools. What the
+ * player wrote there stays; it returns the files written.
  */
-export declare function setUpHosts(folder: string, platform: string): string[];
+export declare function setUpHosts(folder: string, platform: string, userHome?: string): string[];
 /**
  * The files an older init wrote in a folder, or left out, that this version would write otherwise, by their paths in it: the AI and the page then ask the
  * player to run init again. None in a folder init never set up.
@@ -12,10 +13,13 @@ export declare function outdatedHostFiles(folder: string, platform: string): str
 /** Where Codex reads a folder's hooks, which it runs only once the player trusts them. */
 export declare function codexHooksPath(folder: string): string;
 /**
- * Whether the host runs the doorbell's hook init writes, Claude Code and Codex by the names they give the server, so the player's act on the page wakes
- * the chat; the command line, which names no host, is taken as one. Elsewhere the player tells the chat in its window.
+ * Whether the host runs the hooks init writes, the doorbell and the note of how each chat starts: Claude Code, Codex and Antigravity by the names they give
+ * the server, so the player's act on the page wakes the chat; the command line, which names no host, is taken as one. Elsewhere the player tells the
+ * chat in its window.
  */
 export declare function hasDoorbell(host: string | undefined): boolean;
+/** The hosts that run the hooks init writes, by the names they give the server: Antigravity's too (D-115). */
+export declare const hookedHosts: readonly string[];
 /** The instructions of the AI opponent, read from the package wherever it is installed: the MCP server's `instructions` tool gives them (D-102). */
 export declare function opponentInstructions(): string;
 /** The lines that start a chat, in the MCP server's instructions and in AGENTS.md: call `instructions`, then `status` (D-102). */

package/dist/host-files/host-files.js

@@ -4,13 +4,14 @@ import { join, relative } from "node:path";
 import { makeFolder, writeAtomically } from "../games/index.js";
 import { agentFiles, agentHosts, instructionsFile } from "./agents.js";
 /**
- * Sets up the player's folder for Claude Code and Codex (D-31): .mcp.json with the chesspal server, AGENTS.md with the lines that start a chat between
- * Chesspal's marks (D-102), CLAUDE.md importing it, the hosts' settings with the server approved, and their hooks. What the player wrote there stays; it returns
- * the files written.
+ * Sets up the player's folder for Claude Code, Codex and Antigravity (D-31, D-115): .mcp.json with the chesspal server, AGENTS.md with the lines that start
+ * a chat between Chesspal's marks (D-102), CLAUDE.md importing it, the hosts' settings with the server approved, and their hooks. With the user's home
+ * given, where Antigravity is installed, the chesspal server in its settings for every folder too, which alone give the first chat its tools. What the
+ * player wrote there stays; it returns the files written.
  */
-export function setUpHosts(folder, platform) {
+export function setUpHosts(folder, platform, userHome) {
     makeFolder(folder);
-    const written = hostChanges(folder, platform);
+    const written = [...hostChanges(folder, platform), ...(userHome === undefined ? [] : globalChanges(userHome, platform))];
     for (const { path, text } of written) {
         makeFolder(join(path, ".."));
         writeAtomically(path, text);
@@ -32,12 +33,15 @@ export function codexHooksPath(folder) {
     return join(folder, ".codex", "hooks.json");
 }
 /**
- * Whether the host runs the doorbell's hook init writes, Claude Code and Codex by the names they give the server, so the player's act on the page wakes
- * the chat; the command line, which names no host, is taken as one. Elsewhere the player tells the chat in its window.
+ * Whether the host runs the hooks init writes, the doorbell and the note of how each chat starts: Claude Code, Codex and Antigravity by the names they give
+ * the server, so the player's act on the page wakes the chat; the command line, which names no host, is taken as one. Elsewhere the player tells the
+ * chat in its window.
  */
 export function hasDoorbell(host) {
-    return host === undefined || agentHosts.includes(host);
+    return host === undefined || hookedHosts.includes(host);
 }
+/** The hosts that run the hooks init writes, by the names they give the server: Antigravity's too (D-115). */
+export const hookedHosts = [...agentHosts, "antigravity-client"];
 /** The instructions of the AI opponent, read from the package wherever it is installed: the MCP server's `instructions` tool gives them (D-102). */
 export function opponentInstructions() {
     return instructionsFile("opponent");
@@ -52,9 +56,23 @@ const endMark = "<!-- chesspal: end -->";
 const markedBlock = /<!-- chesspal: (?!end)[^\n]*\n[\s\S]*?<!-- chesspal: end -->/;
 /** What init writes for each host, missing or changed: what the player wrote there stays. */
 function hostChanges(folder, platform) {
-    const changes = [mcpFile(folder, platform), agentsFile(folder), claudeFile(folder), claudeSettingsFile(folder), ...agentChanges(folder), codexConfigFile(folder, platform), codexHooksFile(folder)];
+    const changes = [
+        mcpFile(folder, platform),
+        agentsFile(folder),
+        claudeFile(folder),
+        claudeSettingsFile(folder),
+        ...agentChanges(folder),
+        codexConfigFile(folder, platform),
+        codexHooksFile(folder),
+        antigravityHooksFile(folder),
+    ];
     return changes.filter((change) => change !== undefined);
 }
+/** What init writes outside the player's folder, in the user's home: the chesspal server in Antigravity's settings for every folder, where it is installed. */
+function globalChanges(userHome, platform) {
+    const change = antigravityInstalled(userHome, platform) ? antigravityServerFile(userHome, platform) : undefined;
+    return change === undefined ? [] : [change];
+}
 /** How a host starts the server: on Windows through cmd, which finds npm's shim. */
 function chesspalServer(platform) {
     return platform === "win32" ? { command: "cmd", args: ["/c", "chesspal", "mcp"] } : { command: "chesspal", args: ["mcp"] };
@@ -166,6 +184,36 @@ const codexBellHook = {
 };
 // Codex's SessionStart hook: it notes how each chat starts, as Claude Code's does (D-57).
 const codexChatHook = { type: "command", command: "chesspal chat", commandWindows: "chesspal.cmd chat" };
+/**
+ * Antigravity's hooks, which it runs in a folder the player trusts, under a name of Chesspal's beside the player's own (D-115): how each chat starts
+ * (D-57), and the doorbell, which holds the turn's end until the player acts on the page; a day at most. Both read the chat's folder from their input,
+ * since Antigravity runs them in .agents.
+ */
+function antigravityHooksFile(folder) {
+    const path = join(folder, ".agents", "hooks.json");
+    const hooks = {
+        SessionStart: [{ type: "command", command: "chesspal chat", timeout: 30 }],
+        Stop: [{ type: "command", command: "chesspal listen --antigravity", timeout: 86_400 }],
+    };
+    return changed(path, { ...jsonOf(path), chesspal: hooks });
+}
+/**
+ * Antigravity's MCP servers for every folder, with the chesspal server beside the player's: its first chat gets the tools of these alone, not of the
+ * folder's (Priya). No environment of Chesspal's, since Antigravity hands its own to the server, CHESSPAL_HOME with it; one the player gave stays. Never
+ * a backslash, which Antigravity refuses; a file left empty is no server at all.
+ */
+function antigravityServerFile(userHome, platform) {
+    const path = join(userHome, ".gemini", "config", "mcp_config.json");
+    const config = textOf(path)?.trim() === "" ? {} : jsonOf(path);
+    const servers = isObject(config.mcpServers) ? config.mcpServers : {};
+    const before = isObject(servers.chesspal) ? servers.chesspal : {};
+    return changed(path, { ...config, mcpServers: { ...servers, chesspal: { ...chesspalServer(platform), ...(isObject(before.env) ? { env: before.env } : {}) } } });
+}
+/** Whether Antigravity's command line is on this computer: its own folder in the user's home, made at its first start, or its program where its installer puts it. */
+function antigravityInstalled(userHome, platform) {
+    const program = platform === "win32" ? join(userHome, "AppData", "Local", "agy", "bin", "agy.exe") : join(userHome, ".local", "bin", "agy");
+    return existsSync(join(userHome, ".gemini", "antigravity-cli")) || existsSync(program);
+}
 /** A JSON file's new content, when it differs from what is there. */
 function changed(path, value) {
     const text = `${JSON.stringify(value, null, 2)}\n`;

package/dist/host-files/index.d.ts

@@ -1,2 +1,2 @@
 export { agentHosts, agentTools, analystAgent, coachAgent, hasAgent, instructionsFile, isCodex, onQuickModel, ponderAgentFor, ponderAgents } from "./agents.ts";
-export { codexHooksPath, hasDoorbell, opponentInstructions, outdatedHostFiles, setUpHosts, startInstructions } from "./host-files.ts";
+export { codexHooksPath, hasDoorbell, hookedHosts, opponentInstructions, outdatedHostFiles, setUpHosts, startInstructions } from "./host-files.ts";

package/dist/host-files/index.js

@@ -1,3 +1,3 @@
 // The files through which an AI host finds Chesspal in the player's folder: the server, the opponent's instructions, the hosts' settings.
 export { agentHosts, agentTools, analystAgent, coachAgent, hasAgent, instructionsFile, isCodex, onQuickModel, ponderAgentFor, ponderAgents } from "./agents.js";
-export { codexHooksPath, hasDoorbell, opponentInstructions, outdatedHostFiles, setUpHosts, startInstructions } from "./host-files.js";
+export { codexHooksPath, hasDoorbell, hookedHosts, opponentInstructions, outdatedHostFiles, setUpHosts, startInstructions } from "./host-files.js";

package/dist/page/app/app.js

@@ -131,7 +131,7 @@ export function App({ start }) {
             apply(settingsFrom(served.settings));
         }
     }, [profileId]);
-    // The AI as the host names it (Claude, Codex), also where the page sends the player to write; the last known while the page is offline.
+    // The AI as the host names it (Claude, Codex, Gemini), also where the page sends the player to write; the last known while the page is offline.
     const name = served?.opponent ?? text.ai;
     // Under it, the model and effort the AI played its last move with (D-82).
     const signed = served?.aiModel === undefined ? undefined : signature(served.aiModel.model, served.aiModel.effort);

package/dist/page/guide/en.md

@@ -18,7 +18,7 @@ No chess engine plays for the AI: every move and every judgment is its own. Ches
 
 ### Getting started
 
-1. Click the **AI's name**, at the top left, and choose its chat among those on your computer: **Claude Code** or **Codex**. It opens in a window of its own: keep it open while you play. The first time it asks some questions. Whether you trust the folder: **Yes** (in Claude Code No is chosen already: go down to Yes with the arrow keys, then Enter). With Codex, about the hooks, Chesspal's two helpers: **Trust all and continue**. On Windows Codex also asks whether to set up its sandbox, the protected space it works in: choose the first option, and yes when Windows asks for permission.
+1. Click the **AI's name**, at the top left, and choose its chat among those on your computer: **Claude Code**, **Codex** or **Antigravity**. It opens in a window of its own: keep it open while you play. The first time it asks some questions. Whether you trust the folder: **Yes** (in Claude Code No is chosen already: go down to Yes with the arrow keys, then Enter). With Codex, about the hooks, Chesspal's two helpers: **Trust all and continue**. On Windows Codex also asks whether to set up its sandbox, the protected space it works in: choose the first option, and yes when Windows asks for permission.
 2. Press **New game**, choose your colour, the clock and the AI's level, and press **Start**.
 3. Move: the AI answers on the board, and with a few words under its name.
 
@@ -37,7 +37,7 @@ No chess engine plays for the AI: every move and every judgment is its own. Ches
 
 - You talk with the AI in the **box under its name**, a few words with each move: it reads them with your move. You can also write to it in its window. With Codex, if you write there while it waits for your move, press **Esc** after Enter: else it reads your message only after your move.
 - A **move written** in the chat counts too: `e4`, `Nf3`, with the English letters of the pieces (K Q R B N), or in words.
-- **The AI's name** opens the choice of its chat: Claude Code or Codex, the model (which AI: some are faster, others stronger) and how much it reasons. The more it reasons, the slower it plays. If you change them, the chat starts afresh in the same window: the AI forgets what you talked about, and the game stays as it is. In analysis the name stands over the box where you write to it.
+- **The AI's name** opens the choice of its chat: Claude Code, Codex or Antigravity, the model (which AI: some are faster, others stronger) and how much it reasons. The more it reasons, the slower it plays. If you change them, the chat starts afresh in the same window: the AI forgets what you talked about, and the game stays as it is. In analysis the name stands over the box where you write to it.
 - At each **new game**, the chat the page opened starts afresh by itself, once the AI has stopped thinking: a long chat makes the AI slower.
 
 ## Helps and marks

package/dist/page/guide/it.md

@@ -18,7 +18,7 @@ Nessun motore di scacchi gioca al posto dell'AI: ogni mossa e ogni giudizio sono
 
 ### Per cominciare
 
-1. Clicca il **nome dell'AI**, in alto a sinistra, e scegli la chat fra quelle che hai sul computer: **Claude Code** o **Codex**. Si apre in una finestra sua: tienila aperta mentre giochi. La prima volta fa qualche domanda. Se ti fidi della cartella: **Sì** (in Claude Code è già scelto No: scendi su Yes con le frecce, poi Invio). Con Codex, sugli hook, i due aiutanti di Chesspal: **Trust all and continue**. Su Windows Codex chiede anche se preparare la sua sandbox, lo spazio protetto dove lavora: scegli la prima opzione, e sì quando Windows chiede il permesso.
+1. Clicca il **nome dell'AI**, in alto a sinistra, e scegli la chat fra quelle che hai sul computer: **Claude Code**, **Codex** o **Antigravity**. Si apre in una finestra sua: tienila aperta mentre giochi. La prima volta fa qualche domanda. Se ti fidi della cartella: **Sì** (in Claude Code è già scelto No: scendi su Yes con le frecce, poi Invio). Con Codex, sugli hook, i due aiutanti di Chesspal: **Trust all and continue**. Su Windows Codex chiede anche se preparare la sua sandbox, lo spazio protetto dove lavora: scegli la prima opzione, e sì quando Windows chiede il permesso.
 2. Premi **Nuova partita**, scegli il colore, l'orologio e il livello dell'AI, e premi **Inizia**.
 3. Muovi: l'AI risponde sulla scacchiera, e con qualche parola sotto il suo nome.
 
@@ -37,7 +37,7 @@ Nessun motore di scacchi gioca al posto dell'AI: ogni mossa e ogni giudizio sono
 
 - Parli con l'AI nella **casella sotto il suo nome**, qualche parola a ogni mossa: le legge con la tua mossa. Puoi scriverle anche nella sua finestra. Con Codex, se gli scrivi lì mentre aspetta la tua mossa, dopo Invio premi **Esc**: se no legge il messaggio solo dopo la tua mossa.
 - Anche una **mossa scritta** nella chat vale: `e4`, `Nf3`, con le lettere inglesi dei pezzi (K Q R B N), o a parole.
-- **Il nome dell'AI** apre la scelta della chat: Claude Code o Codex, il modello (quale AI: alcune sono più veloci, altre più forti) e quanto ragiona. Più ragiona, più gioca lenta. Se cambi, la chat riparte da capo nella stessa finestra: l'AI dimentica la chiacchierata di prima, la partita resta com'è. Nell'analisi il nome sta sopra la casella dove le scrivi.
+- **Il nome dell'AI** apre la scelta della chat: Claude Code, Codex o Antigravity, il modello (quale AI: alcune sono più veloci, altre più forti) e quanto ragiona. Più ragiona, più gioca lenta. Se cambi, la chat riparte da capo nella stessa finestra: l'AI dimentica la chiacchierata di prima, la partita resta com'è. Nell'analisi il nome sta sopra la casella dove le scrivi.
 - A ogni **nuova partita** la chat aperta dalla pagina riparte da capo da sola, se l'AI ha finito di pensare: una chat lunga rende l'AI più lenta.
 
 ## Gli aiuti e i segni

package/dist/page/profile/settings.js

@@ -36,6 +36,8 @@ export function settingsFrom(value, defaults = { theme: "system", sound: true })
         claudeEffort: word(stored.claudeEffort),
         codexModel: word(stored.codexModel),
         codexEffort: word(stored.codexEffort),
+        antigravityModel: word(stored.antigravityModel),
+        antigravityEffort: word(stored.antigravityEffort),
     };
 }
 /** Remembers the settings in this browser. */