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

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:

1

Install Zilliz CLI.

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

macOS / Linux

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

Windows

irm https://zilliz.com/cli/install.ps1 | iex

Verify installation:

zilliz --version

2

Authenticate.

Authenticate with your Zilliz Cloud account:

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:

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

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

  Windows

  irm https://zilliz.com/cli/install.ps1 | iex

• Authentication fails

  Solution:

  1. Check your internet connection

  2. Verify your Zilliz Cloud account is active

  3. Try logging out and back in:

  zilliz logout
  zilliz login

1. "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.