Command reference ยท Antigravity CLI
agy plugin install <path>
Installs a local or downloaded plugin directory.
agy plugin install <path> installs a plugin bundle from a local directory or a remote source into the local profile under ~/.gemini/antigravity-cli/plugins/<plugin_name>/. A valid plugin consists of the required manifest plugin.json plus optional subfolders such as skills/, agents/, rules/, and the files mcp_config.json or hooks.json.
Since version 1.0.7, plugins can also be installed directly from GitHub subpaths, including branch resolution. For external installations, the CLI has automatically resolved and initialized included Git submodules since version 1.0.9. When copying, the entire plugin directory is taken over, including non-skill subfolders like shared/ โ an earlier bug that discarded such folders on import was fixed in version 1.0.14.
Related subcommands are agy plugin list, agy plugin disable/enable <name>, and agy plugin uninstall <name>. The command is intended for native plugin.json packages, not for Gemini CLI extensions in the legacy format.
โ WHEN TO USE IT?
Integrate a locally developed plugin directory
agy plugin install ./my-plugin
Install a plugin directly from a GitHub repo subpath
agy plugin install github.com/org/repo/path/to/plugin
โ WHEN NOT TO?
Wanting to adopt only a legacy Gemini CLI extension
plugin install expects a native plugin.json manifest, not a Gemini CLI extension directly.
Better: use agy plugin import gemini to convert extensions first
Wanting to activate a plugin only briefly for testing
install permanently copies the directory into the local profile, which is unnecessary for a brief test.
Better: Use agy plugin uninstall <name> after the test, or agy plugin disable <name> to deactivate temporarily
SOURCES
- Antigravity CLI docs: Plugins โ antigravity.google
- Antigravity CLI CHANGELOG (GitHub) โ raw.githubusercontent.com