Skip to content

antigravity-research.md

Latest commit

 

History

History
78 lines (51 loc) · 3.99 KB

antigravity-research.md

File metadata and controls

78 lines (51 loc) · 3.99 KB
Raw

Antigravity CLI — Plugin Research (Task 38, archival)

Amendment (2026-06-24): The shared core was renamed @nodesource/plugin-core → nsolid-plugin. The scripts/install.js approach described below was superseded — Antigravity now installs directly from the GitHub repository root with agy plugin install https://github.com/NodeSource/nsolid-plugin.git, followed by explicit nsolid-plugin setup --harness antigravity.

Status: Complete (June 2026).
Verdict at the time: Antigravity had no install-time/session-start hook, so the plugin design originally used a one-time scripts/install.js that the user ran manually. This design is now archival; current installs use the repository root as the native Antigravity plugin.

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. Superseded design for Task 26

This section documents the original design only. Do not use it for current installs; use agy plugin install https://github.com/NodeSource/nsolid-plugin.git and then nsolid-plugin setup --harness antigravity.

  • 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/.