agy plugin install <path>
安装一个本地或已下载的插件目录。
agy plugin install <路径> 会把一个插件包从本地目录或远程来源安装到本地配置文件夹 ~/.gemini/antigravity-cli/plugins/<plugin_name>/ 下。一个有效的插件由必需的清单文件 plugin.json,以及可选的子目录如 skills/、agents/、rules/,还有 mcp_config.json 或 hooks.json 文件组成。
自 1.0.7 版起,插件也可以直接从 GitHub 子路径安装,包括分支解析。自 1.0.9 版起,在进行外部安装时,CLI 会自动解析并初始化插件中包含的 Git 子模块。复制时会完整保留整个插件目录,包括 shared/ 这类非 skill 子文件夹——早期版本中一个会在导入时丢弃此类文件夹的 bug,已在 1.0.14 版中修复。
相关的子命令还有 agy plugin list、agy plugin disable/enable <name> 和 agy plugin uninstall <name>。该命令是为原生 plugin.json 格式的软件包设计的,不适用于旧格式的 Gemini CLI 扩展。
✅ 什么时候用?
接入一个本地开发的插件目录
agy plugin install ./mein-plugin
直接从 GitHub 仓库的子路径安装插件
agy plugin install github.com/org/repo/pfad/zum/plugin
⛔ 什么时候不该用?
只想接入一个旧版 Gemini CLI 扩展
plugin install 需要原生的 plugin.json 清单文件,不能直接接受 Gemini CLI 扩展。
更好的选择: 先用 agy plugin import gemini 把扩展转换过来
只想短暂启用一个插件做测试
install 会把目录永久复制到本地配置文件夹中,对于短暂测试来说没有必要。
更好的选择: 测试完成后使用 agy plugin uninstall <name>,或用 agy plugin disable <name> 临时禁用
来源
- Antigravity CLI 文档:Plugins ↗ antigravity.google
- Antigravity CLI CHANGELOG (GitHub) ↗ raw.githubusercontent.com