W-23057147: Skills and MCP support for Gemini, Antigravity, and Copilot CLI

.changeset/gemini-copilot-antigravity-skills-mcp.md

@@ -0,0 +1,11 @@
+---
+'@salesforce/b2c-cli': minor
+'@salesforce/b2c-tooling-sdk': minor
+'b2c-vs-extension': patch
+'@salesforce/b2c-agent-plugins': patch
+'@salesforce/b2c-dx-docs': patch
+---
+
+Add first-class support for installing B2C agent skills and the `b2c-dx-mcp` MCP server in Gemini and Google Antigravity. `b2c setup skills` now accepts `--ide gemini-cli` (writes to `.gemini/skills`) and `--ide antigravity` (writes to `.agents/skills`), a Gemini CLI extension bundles the MCP server plus project context (`gemini extensions install <repo>`), and the docs cover Gemini CLI, Gemini Code Assist, and Antigravity (IDE/CLI/SDK), including which surfaces are not supported (the consumer Gemini and Microsoft Copilot desktop apps). Scope note: Antigravity support was folded into this work alongside Gemini and GitHub Copilot.
+
+The VS Code extension's "Set Up Agent Skills & MCP" walkthrough now includes a dedicated **GitHub Copilot CLI** card (installs skills via the marketplace-plugin command, with a proper uninstall-then-install "Reinstall"), detects and displays per-tool **MCP server** status alongside skills status, and clarifies the summary counts (tools supported · detected here · with skills · with MCP). The MCP action reads "Re-configure MCP" once a server is registered. The "Install the B2C CLI" step now shows the detected `b2c-cli` version and disables "Update CLI" when the CLI is already up to date.

GEMINI.md

@@ -0,0 +1,43 @@
+# Salesforce B2C Commerce — Project Context
+
+This context is provided by the **B2C Developer Tooling** Gemini CLI extension. It
+helps Gemini assist with Salesforce B2C Commerce development: SFRA storefronts,
+cartridge code, SCAPI/OCAPI, jobs, On-Demand Sandboxes, and headless (PWA Kit / MRT)
+projects.
+
+## Available capabilities
+
+- **`b2c-dx-mcp` MCP server** (bundled by this extension) — exposes B2C tools:
+  deploy cartridges, run and monitor jobs, manage On-Demand Sandboxes, stream logs,
+  and search B2C Commerce documentation. Prefer these tools over ad-hoc shell
+  commands when performing B2C operations.
+- **B2C CLI (`b2c`)** — the `@salesforce/b2c-cli` command-line tool. Use it for
+  `b2c setup` (configuration), `b2c code deploy`, `b2c sandbox`, `b2c job`,
+  `b2c logs`, and WebDAV operations. Run `b2c --help` to discover commands.
+- **Agent skills** — install detailed, task-specific B2C skills with:
+
+  ```bash
+  b2c setup skills b2c --ide gemini-cli        # development patterns
+  b2c setup skills b2c-cli --ide gemini-cli    # CLI operations
+  ```
+
+  These install to `~/.gemini/skills/` (global) or `.gemini/skills/` (project),
+  where Gemini CLI discovers them automatically.
+
+## Working conventions
+
+- **Never create or delete an On-Demand Sandbox without explicit user confirmation** —
+  sandbox creation may be a billable action.
+- **Never overwrite an existing `dw.json`** without confirmation — it holds instance
+  credentials and configuration.
+- B2C Commerce has **no self-service signup**; the user must already have Account
+  Manager access and a target instance (sandbox or PIG) provisioned by their org's
+  B2C Commerce admin.
+- If a `b2c` command is not found, use `npx @salesforce/b2c-cli <command>` or install
+  it with `npm install -g @salesforce/b2c-cli`.
+
+## References
+
+- CLI reference: https://salesforcecommercecloud.github.io/b2c-developer-tooling/cli/
+- Agent skills guide: https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/agent-skills
+- MCP installation: https://salesforcecommercecloud.github.io/b2c-developer-tooling/mcp/installation

README.md

@@ -37,7 +37,18 @@ Install B2C Commerce agent skills and plugins in your AI-powered editor. Three p
 
 - **Codex CLI**: run `/plugins` and add from this repo (GitHub URL).
 
-- **Gemini CLI**: `gemini extensions install https://github.com/SalesforceCommerceCloud/b2c-developer-tooling`
+- **Gemini CLI**: install the extension (bundles the MCP server + project context), then add the skills:
+
+    ```
+    gemini extensions install https://github.com/SalesforceCommerceCloud/b2c-developer-tooling
+    npx @salesforce/b2c-cli setup skills b2c --ide gemini-cli
+    ```
+
+- **Google Antigravity** (IDE / CLI / SDK):
+
+    ```
+    npx @salesforce/b2c-cli setup skills b2c --ide antigravity
+    ```
 
 - **Any supported IDE (file-copy install via CLI)**:
 

docs/cli/setup.md

@@ -422,7 +422,7 @@ b2c setup skills [SKILLSET]
 | --------------------- | ---------------------------------------------------------------------------------------------- | ----------- |
 | `--list`, `-l`        | List available skills without installing                                                       | `false`     |
 | `--skill`             | Install specific skill(s) (can be repeated)                                                    |             |
-| `--ide`               | Target IDE(s): claude-code, cursor, windsurf, vscode, codex, opencode, agentforce-vibes, manual | Auto-detect |
+| `--ide`               | Target IDE(s): claude-code, cursor, windsurf, vscode, codex, opencode, gemini-cli, antigravity, agentforce-vibes, manual | Auto-detect |
 | `--directory`, `-d`   | Custom installation directory (overrides IDE default path)                                     |             |
 | `--global`, `-g`      | Install to user home directory (global scope)                                                  | `false`     |
 | `--update`, `-u`      | Update existing skills (overwrite)                                                             | `false`     |
@@ -442,11 +442,15 @@ b2c setup skills [SKILLSET]
 | `vscode`           | VS Code / GitHub Copilot | `.github/skills/`     | `~/.copilot/skills/`                                |
 | `codex`            | OpenAI Codex CLI         | `.codex/skills/`      | `~/.codex/skills/`                                  |
 | `opencode`         | OpenCode                 | `.opencode/skills/`   | `~/.config/opencode/skills/`                        |
+| `gemini-cli`       | Gemini CLI               | `.gemini/skills/`     | `~/.gemini/skills/`                                 |
+| `antigravity`      | Google Antigravity       | `.agents/skills/`     | `~/.gemini/config/skills/`                          |
 | `agentforce-vibes` | Agentforce Vibes         | `.a4drules/skills/`   | `~/Library/Application Support/Code/User/globalStorage` (macOS) |
 | `manual`           | Manual                   | `.agents/skills/`     | `~/.agents/skills/`                                 |
 
 Use `agentforce-vibes` for Salesforce Agentforce for VS Code. Use `manual` for generic installation with a custom `--directory` path.
 
+For `gemini-cli`, the [Gemini CLI extension](/guide/agent-skills#gemini-cli) (`gemini extensions install …`) also installs the `b2c-dx-mcp` MCP server and B2C project context. For `antigravity`, the same skills serve the Antigravity IDE, CLI, and SDK; configure the MCP server separately via `.agents/mcp_config.json` (see [MCP Installation](/mcp/installation#google-antigravity)).
+
 ### Examples
 
 ```bash
@@ -470,6 +474,12 @@ b2c setup skills b2c --ide cursor --ide windsurf
 # Install specific skills only
 b2c setup skills b2c-cli --skill b2c-code --skill b2c-webdav --ide cursor
 
+# Install to Gemini CLI (.gemini/skills/)
+b2c setup skills b2c-cli --ide gemini-cli
+
+# Install to Google Antigravity (.agents/skills/)
+b2c setup skills b2c --ide antigravity
+
 # Install to Agentforce Vibes (.a4drules/skills/)
 b2c setup skills b2c --ide agentforce-vibes
 

docs/guide/agent-skills.md

@@ -1,12 +1,12 @@
 ---
-description: Agentic B2C Developer Toolkit — AI agent skills and plugins that teach Agentforce Vibes, Claude Code, Codex, Cursor, and GitHub Copilot the full B2C Commerce stack.
+description: Agentic B2C Developer Toolkit — AI agent skills and plugins that teach Agentforce Vibes, Claude Code, Codex, Cursor, Gemini, Google Antigravity, and GitHub Copilot the full B2C Commerce stack.
 ---
 
 # Agent Skills & Plugins
 
 Turn your coding agent into a B2C Commerce specialist. Skills cover the full platform — storefront and headless development, operational workflows, and everything in between — so your agent knows both how B2C Commerce works and which CLI commands to run.
 
-Skills follow the open [Agent Skills](https://agentskills.io/home) standard and work with Agentforce Vibes, Claude Code, Cursor, GitHub Copilot (VS Code and CLI), Codex, OpenCode, and others. Install from your IDE's plugin marketplace or the B2C CLI (`b2c setup skills`).
+Skills follow the open [Agent Skills](https://agentskills.io/home) standard and work with Agentforce Vibes, Claude Code, Cursor, GitHub Copilot (VS Code and CLI), Gemini CLI, Google Antigravity (IDE/CLI/SDK), Codex, OpenCode, and others. Install from your IDE's plugin marketplace or the B2C CLI (`b2c setup skills`).
 
 ## Quick Start
 
@@ -61,6 +61,22 @@ copilot plugin install storefront-next@b2c-developer-tooling
 copilot plugin install storefront-next-figma@b2c-developer-tooling
 ```
 
+```bash [Gemini CLI]
+# One command installs the MCP server + project context:
+gemini extensions install https://github.com/SalesforceCommerceCloud/b2c-developer-tooling
+
+# Then add the agent skills (discovered from .gemini/skills):
+npx @salesforce/b2c-cli setup skills b2c --ide gemini-cli
+npx @salesforce/b2c-cli setup skills b2c-cli --ide gemini-cli
+```
+
+```bash [Antigravity]
+# Google Antigravity (IDE/CLI/SDK) reads skills from .agents/skills:
+npx @salesforce/b2c-cli setup skills b2c --ide antigravity
+npx @salesforce/b2c-cli setup skills b2c-cli --ide antigravity
+# For the MCP server on Antigravity, see /mcp/installation
+```
+
 ```bash [Agentforce Vibes]
 # Marketplace install coming soon. For now, use the B2C CLI:
 npx @salesforce/b2c-cli setup skills --ide agentforce-vibes
@@ -268,6 +284,77 @@ copilot plugin install storefront-next@b2c-developer-tooling
 copilot plugin install storefront-next-figma@b2c-developer-tooling
 ```
 
+::: warning Microsoft Copilot desktop app is not the same product
+The **Microsoft 365 / Microsoft Copilot desktop app** for Mac and Windows is a productivity assistant — it does **not** run local MCP servers or read repo Agent Skills (its extensibility is limited to tenant-published agents and connected apps). For B2C Commerce development, use **GitHub Copilot in VS Code** or the **Copilot CLI** above; those are GitHub Copilot's desktop surfaces and both are supported here.
+:::
+
+## Gemini
+
+Skills and the `b2c-dx-mcp` MCP server work with **Gemini CLI** and **Gemini Code Assist** (VS Code / JetBrains).
+
+### Gemini CLI
+
+The fastest path is the Gemini CLI extension, which bundles the MCP server and B2C project context (`GEMINI.md`) in a single install:
+
+```bash
+gemini extensions install https://github.com/SalesforceCommerceCloud/b2c-developer-tooling
+```
+
+Update or remove it later with:
+
+```bash
+gemini extensions update b2c-developer-tooling
+gemini extensions uninstall b2c-developer-tooling
+```
+
+The extension does **not** bundle the agent skills (the repo's skills are plugin-grouped, not laid out at the extension root). Install them with the B2C CLI — they land in the directories Gemini CLI discovers automatically:
+
+::: code-group
+
+```bash [Project Scope]
+b2c setup skills b2c --ide gemini-cli
+b2c setup skills b2c-cli --ide gemini-cli
+```
+
+```bash [User Scope]
+b2c setup skills b2c --ide gemini-cli --global
+b2c setup skills b2c-cli --ide gemini-cli --global
+```
+
+:::
+
+This writes to `.gemini/skills/` (project) or `~/.gemini/skills/` (user). Gemini CLI also reads `.agents/skills/`.
+
+### Gemini Code Assist (VS Code / JetBrains)
+
+Gemini Code Assist shares configuration with the Gemini CLI. In **VS Code**, once you've installed the extension (or added the MCP server to `~/.gemini/settings.json`), the `b2c-dx-mcp` tools are available in agent mode. In **JetBrains**, configure the MCP server via the IDE's MCP settings and use `GEMINI.md` / `AGENT.md` for context. See [MCP Installation](/mcp/installation) for the exact server configuration.
+
+::: warning Gemini desktop app (Mac/Windows) is not supported
+The standalone **Gemini app** for Mac and Windows is a consumer assistant. It supports only Gems and Google-curated connected apps — it does **not** run local MCP servers or read repo Agent Skills. For B2C Commerce development, use **Gemini CLI**, **Gemini Code Assist**, or **Google Antigravity** instead.
+:::
+
+## Google Antigravity
+
+[Google Antigravity](https://antigravity.google/) is an agent-first development platform available as an **IDE**, a **CLI**, and a **Python SDK**. It implements the same open [Agent Skills](https://antigravity.google/docs/skills) standard (`SKILL.md` folders) and supports MCP servers over stdio, so the B2C skills and `b2c-dx-mcp` work across all three surfaces.
+
+Install the skills with the B2C CLI:
+
+::: code-group
+
+```bash [Project Scope]
+b2c setup skills b2c --ide antigravity
+b2c setup skills b2c-cli --ide antigravity
+```
+
+```bash [User Scope]
+b2c setup skills b2c --ide antigravity --global
+b2c setup skills b2c-cli --ide antigravity --global
+```
+
+:::
+
+This writes to `.agents/skills/` (workspace) or `~/.gemini/config/skills/` (global) — the locations Antigravity discovers. For the `b2c-dx-mcp` MCP server, add it to `.agents/mcp_config.json` (workspace) or `~/.gemini/config/mcp_config.json` (global); see [MCP Installation](/mcp/installation).
+
 ## B2C CLI
 
 Interactive — select skillsets and IDEs:
@@ -338,13 +425,15 @@ b2c setup skills b2c --ide agentforce-vibes --global
 Use [`b2c setup skills`](/cli/setup) for any supported IDE.
 :::
 
-| IDE                                                                                        | Flag             |
-| ------------------------------------------------------------------------------------------ | ---------------- |
-| [Cursor](https://cursor.com/docs/skills)                                                   | `--ide cursor`   |
-| [Windsurf](https://docs.windsurf.com/)                                                     | `--ide windsurf` |
-| [VS Code / Copilot](https://code.visualstudio.com/docs/copilot/customization/agent-skills) | `--ide vscode`   |
-| [Codex CLI](https://github.com/openai/codex)                                               | `--ide codex`    |
-| [OpenCode](https://opencode.ai/)                                                           | `--ide opencode` |
+| IDE                                                                                        | Flag                |
+| ------------------------------------------------------------------------------------------ | ------------------- |
+| [Cursor](https://cursor.com/docs/skills)                                                   | `--ide cursor`      |
+| [Windsurf](https://docs.windsurf.com/)                                                     | `--ide windsurf`    |
+| [VS Code / Copilot](https://code.visualstudio.com/docs/copilot/customization/agent-skills) | `--ide vscode`      |
+| [Codex CLI](https://github.com/openai/codex)                                               | `--ide codex`       |
+| [OpenCode](https://opencode.ai/)                                                           | `--ide opencode`    |
+| [Gemini CLI](https://google-gemini.github.io/gemini-cli/)                                  | `--ide gemini-cli`  |
+| [Google Antigravity](https://antigravity.google/docs/skills)                               | `--ide antigravity` |
 
 ### Manual Installation
 
@@ -357,14 +446,16 @@ b2c setup skills b2c --ide manual --directory ./my-skills
 
 For reference, the install locations each `--ide` flag writes to:
 
-| IDE               | Project             | User                          |
-| ----------------- | ------------------- | ----------------------------- |
-| Cursor            | `.cursor/skills/`   | `~/.cursor/skills/`           |
-| Windsurf          | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
-| VS Code / Copilot | `.github/skills/`   | `~/.copilot/skills/`          |
-| Codex CLI         | `.codex/skills/`    | `~/.codex/skills/`            |
-| OpenCode          | `.opencode/skills/` | `~/.config/opencode/skills/`  |
-| Agentforce Vibes  | `.a4drules/skills/` | IDE's global storage          |
+| IDE                | Project             | User                          |
+| ------------------ | ------------------- | ----------------------------- |
+| Cursor             | `.cursor/skills/`   | `~/.cursor/skills/`           |
+| Windsurf           | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
+| VS Code / Copilot  | `.github/skills/`   | `~/.copilot/skills/`          |
+| Codex CLI          | `.codex/skills/`    | `~/.codex/skills/`            |
+| OpenCode           | `.opencode/skills/` | `~/.config/opencode/skills/`  |
+| Gemini CLI         | `.gemini/skills/`   | `~/.gemini/skills/`           |
+| Google Antigravity | `.agents/skills/`   | `~/.gemini/config/skills/`    |
+| Agentforce Vibes   | `.a4drules/skills/` | IDE's global storage          |
 
 ## Usage Examples