fluid-cli

Official CLI for Fluid — inspect and diagnose Fluid-managed Datasets and their Kubernetes resources.

Install the fluid binary on your PATH.

Quick start

git clone https://github.com/fluid-cloudnative/fluid-cli.git
cd fluid-cli
make install-plugin

fluid --help
fluid inspect my-dataset -n default
fluid diagnose my-dataset -n default --archive

Commands

Command	Description
fluid inspect	List Pods, Runtimes, PVCs, and related resources for a Dataset
fluid diagnose	Collect a support bundle (YAML, logs, events) for a Dataset
fluid diagnose config	Manage AI/LLM settings for diagnose (~/.fluid/config)
fluid version	Print CLI version

For flags and examples, use --help on any command:

fluid inspect --help
fluid diagnose --help

AI-assisted diagnosis

fluid diagnose can call an OpenAI-compatible LLM API to analyze collected cluster context, or export prompt files for manual copy/paste.

# Interactive setup (Bubble Tea form)
fluid diagnose config

# Or set values via CLI / env
export FLUID_LLM_API_KEY=sk-...
fluid diagnose my-dataset -n default -o dir

Artifact directory includes context.json and prompt.txt by default. Pass --llm to also write llm-analysis.txt when an endpoint and API key are configured.

See Diagnose guide for details.

Documentation

• Install
• Inspect guide
• Diagnose guide
• Troubleshooting
• Command reference (auto-generated from Cobra; run make docs to refresh)

Development

See CONTRIBUTING.md.

make build    # build bin/fluid
make test     # unit tests
make docs     # regenerate docs/reference/

License

Apache License 2.0 — see LICENSE.