Zilliz Gemini CLI Extension
The Zilliz Cloud extension for Gemini CLI is a natural language interface that brings Zilliz Cloud operations directly into your IDE. Instead of memorizing CLI commands or switching to the web console, describe what you want in plain language and the plugin handles it.
What it does
-
Translates natural-language requests into
zilliz-clicommands -
Covers all major Zilliz Cloud operations: clusters, databases, collections, partitions, indexes, vectors, imports, backups, users/roles, monitoring, projects, and billing
-
Embeds live
--helpoutput at invocation time so the assistant always has up-to-date flag information -
Requires explicit user confirmation before any destructive operation
Prerequisites
- You have installed Gemini CLI.
Setup Procedure
gemini extensions install https://github.com/zilliztech/gemini-cli-extension
Alternatively, you can first clone this repo locally, and run the following command:
gemini extensions link /path/to/gemini-cli-extension
Initial Setup
After installation, run the quickstart wizard:
/zilliz:setup
The wizard will guide you through:
Install Zilliz CLI.
The plugin requires the Zilliz CLI. If not installed, run:
- macOS / Linux
- Windows
curl -fsSL https://zilliz.com/cli/install.sh | bash
irm https://zilliz.com/cli/install.ps1 | iex
Verify installation:
zilliz --version
Authenticate.
Authenticate with your Zilliz Cloud account:
zilliz auth login
This opens a browser for authentication. After login, your credentials are stored locally.
Connect to your cluster.
Configure your default cluster connection:
zilliz context set --cluster-id <your-cluster-id>
Or let the plugin help you select from available clusters.
Verification
Test the plugin with a simple command:
You: "List my clusters"
The plugin should display your Zilliz Cloud clusters.
Troubleshooting
-
Plugin shows "CLI not found"
Solution: Install the Zilliz CLI:
- macOS / Linux
- Windows
curl -fsSL https://zilliz.com/cli/install.sh | bashirm https://zilliz.com/cli/install.ps1 | iex -
Authentication fails
Solution:
-
Check your internet connection
-
Verify your Zilliz Cloud account is active
-
Try logging out and back in:
zilliz logoutzilliz login -
-
"No cluster configured"
Solution: Set a default cluster:
zilliz context set --cluster-id <cluster-id>
Next Step
Both Zilliz Claude Code Plugin and Zilliz Gemini CLI Extension share Zilliz CLI at the bottom. You can read Zilliz Claude Code Plugin Capabilities and Zilliz Claude Code Plugin Examples to learn how to write prompts.