Skip to main content

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-cli commands

  • Covers all major Zilliz Cloud operations: clusters, databases, collections, partitions, indexes, vectors, imports, backups, users/roles, monitoring, projects, and billing

  • Embeds live --help output 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​

bash
gemini extensions install https://github.com/zilliztech/gemini-cli-extension

Alternatively, you can first clone this repo locally, and run the following command:

bash
gemini extensions link /path/to/gemini-cli-extension

Initial Setup​

After installation, run the quickstart wizard:

bash
/zilliz:setup

The wizard will guide you through:

1

Install Zilliz CLI.

The plugin requires the Zilliz CLI. If not installed, run:

bash
curl -fsSL https://zilliz.com/cli/install.sh | bash

Verify installation:

bash
zilliz --version
2

Authenticate.

Authenticate with your Zilliz Cloud account:

bash
zilliz auth login

This opens a browser for authentication. After login, your credentials are stored locally.

3

Connect to your cluster.

Configure your default cluster connection:

bash
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:

plaintext
You: "List my clusters"

The plugin should display your Zilliz Cloud clusters.

Troubleshooting​

  • Plugin shows "CLI not found"

    Solution: Install the Zilliz CLI:

    bash
    curl -fsSL https://zilliz.com/cli/install.sh | bash

  • Authentication fails

    Solution:

    1. Check your internet connection

    2. Verify your Zilliz Cloud account is active

    3. Try logging out and back in:

    bash
    zilliz logout
    zilliz login

  1. "No cluster configured"

    Solution: Set a default cluster:

    bash
    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.

Contact Sales
Ctrl I