🚀 Antigravity CLI Package Manager

• 🌐 Multi-Marketplace Support: Add and switch between multiple remote GitHub repositories as your plugin sources (e.g. ZaunEkko/agy-plugins).
• ⚡ Hot Updates with Precision: Fetch the newest commit fingerprint from remote repos and perform updates instantly at global, namespace, or individual plugin levels.
• 🖥️ Interactive TUI: Browse, check update status, and batch-install plugins via a stunning terminal user interface built with @clack/prompts.
• 🔐 Zero-Config Private Repos: Natively detects and utilizes your local gh auth token to bypass GitHub API rate limits and access enterprise private plugin repositories.
• 🛡️ Hook & MCP Merging: Merges remote hooks.json and mcp.json into your Antigravity config. Hook arrays are deduplicated, and same-name MCP servers are replaced with a warning so updates stay explicit.

To install agy-plugins-cli globally on your machine, simply run:

Requires Node.js ^22.13.0 || >=23.5.0.

npm install -g agy-plugins-cli@latest

Now you can use the agy-plugin command anywhere in your terminal!

Both methods are 100% compatible and will deduplicate hooks/skills if used simultaneously!

Link a GitHub repository to your local registry and explore its plugins interactively.

# Add a repository as a marketplace
agy-plugin marketplace add ZaunEkko/agy-plugins

# Open the interactive marketplace dashboard (Shows Outdated/Installed status!)
agy-plugin marketplace list

(The interactive TUI lets you browse available plugins, see update dates, and batch install them with a single keystroke!)

Install plugins from the connected marketplace by specifying the plugin name and the repository namespace.

agy-plugin add commit-commands@zaunekko
agy-plugin add explanatory-output-style@zaunekko

(The CLI will securely download the skills, and hooks to your local .gemini/config/ directory!)

Easily fetch and sync the latest plugin updates from the remote authors. Our CLI tracks the local and remote SHA fingerprints to dynamically detect out-of-date plugins.

# Update all installed plugins across all namespaces globally
agy-plugin update

# Update all plugins in a specific namespace
agy-plugin update @zaunekko

# Update a specific plugin directly
agy-plugin update commit-commands@zaunekko

• Official CLI Compatibility & Deduplication: Fully compatible with the native agy plugin install <git-url> mechanism. Whether you install a plugin via our TUI, the native CLI, or both simultaneously, Antigravity gracefully deduplicates hooks and skills by ID/name, ensuring a robust, conflict-free ecosystem.
• Fingerprint Tracking: agy-plugin caches the latest Git sha for downloaded directories in ~/.agy-plugin/installed.json, while marketplace configuration lives in ~/.agy-plugin/config.json. This enables intelligent delta-updates and distinct visual states (Installed vs Update Available) in the TUI.
• Dynamic Context Injection: Antigravity natively loads everything dropped into the .gemini/config/ directory. Our CLI acts as the secure bridge between remote community repos and your local AI context.
• gh CLI Integration: Under the hood, if GITHUB_TOKEN is missing, the tool attempts to extract tokens via gh auth token to ensure your local git workflow is entirely uninterrupted.

This project is open-sourced under the MIT License.