Skip to content

antigravity-research.md

Latest commit

 

History

History
76 lines (50 loc) · 3.7 KB

antigravity-research.md

File metadata and controls

76 lines (50 loc) · 3.7 KB
Raw

Antigravity CLI — Plugin Research (Task 38)

Amendment (2026-06-24): The shared core was renamed @nodesource/plugin-core → nsolid-plugin. The scripts/install.js approach described here was superseded — Antigravity now installs directly from the GitHub repository root. See docs/qa-guide.md §9.

Status: Complete (June 2026).
Verdict: Antigravity has no install-time/session-start hook, so the plugin must ship a one-time scripts/install.js that the user runs manually. That script copies the plugin directory for discovery and invokes the shared core installer so auth, MCP config, and skills work consistently with the other harnesses.

Sources

1. Plugin model

A plugin is a directory containing a root plugin.json:

{ "name": "nodesource-nsolid" }
  • name is optional, defaults to directory name.
  • Auto-discovered components: skills/, rules/, mcp_config.json, hooks.json.
  • Discovery paths: workspace <workspace>/.agents/plugins/<name>/ and global ~/.gemini/config/plugins/<name>/.
  • No third-party marketplace exists. Distribution is manual folder placement or a local installer script.

2. Hooks (no install-time event)

Supported events (complete list):

  • PreToolUse
  • PostToolUse
  • PreInvocation
  • PostInvocation
  • Stop

There is no SessionStart, Startup, or install-time event. The closest, PreInvocation, fires before every model call, making it unsuitable for one-time setup.

3. Skills and MCP paths

Purpose Path
Shared MCP config (preferred) ~/.gemini/config/mcp_config.json
Global skills (all workspaces) ~/.gemini/config/skills/
Workspace skills (per-project) <workspace-root>/.agents/skills/<skill>/
Agy-CLI-only paths (legacy) ~/.gemini/antigravity-cli/mcp_config.json, ~/.gemini/antigravity-cli/skills/

Authoritative source: https://antigravity.google/docs/skills ("Where skills live") lists the global skill location as ~/.gemini/config/skills/, sharing the same ~/.gemini/config/ root as mcp_config.json. An earlier draft of this doc and third-party blog posts cited ~/.gemini/skills/; that path is not read by Antigravity at runtime and was corrected after the adapter shipped the wrong path. The Agy-CLI-only ~/.gemini/antigravity-cli/... paths are legacy and also not used by the cross-product install.

The core adapter (packages/core/src/harnesses/antigravity-adapter.ts) writes MCP config to ~/.gemini/config/mcp_config.json and exposes ~/.gemini/config/skills/ as the skills path; the skill linker delegates to the adapter so the two cannot drift.

4. Env vars in mcp_config.json

Antigravity does not interpolate environment variables in mcp_config.json (confirmed June 2026). Therefore the core installer must expand variables such as ${MCP_ROOT} and ${AUTH_TOKEN} before writing the file.

5. Chosen design for Task 26

  • Ship a native plugin.json.
  • Ship scripts/install.js that the user runs once.
  • The script copies the plugin directory to ~/.gemini/config/plugins/nodesource-nsolid/ and then calls @nodesource/plugin-core's install({ harness: 'antigravity', bundlePath, skillsSource }).
  • Skills and MCP config are not bundled in the plugin; they are produced by the core installer.
  • The core Antigravity adapter is updated to write to ~/.gemini/config/mcp_config.json and ~/.gemini/config/skills/.