This is documentation for the next version of Grafana documentation. For the latest stable release, go to the latest version.

Documentationbreadcrumb arrow Grafana documentationbreadcrumb arrow As codebreadcrumb arrow Observability as codebreadcrumb arrow Grafana CLIbreadcrumb arrow gcx CLI
Grafana Cloud Enterprise Open source

gcx CLI

Manage Grafana and Grafana Cloud from the terminal and from agentic coding tools.

Overview

gcx is the Grafana CLI that allows you and your AI coding agent to work with Grafana Cloud, Grafana Enterprise, and Grafana OSS.

gcx is designed to be used in common scenarios such as authentication against Grafana, query telemetry, inspect and manage resources, and automate observability workflows as code.

It’s also integrated with Grafana Assistant, combining the previously fragmented user experience into one single tool.

Get started

Note

Refer to the gcx repository in GitHub for the complete set of gcx documents, including architecture information, user guides, and other reference material.

Overview
Overview of the gcx CLI.
Installation
Install gcx with the quick installer, Homebrew, or a prebuilt binary.
CLI reference
Commands, flags, environment variables, and configuration for the latest stable release.
Configuration
Configure gcx with the configuration file or using environment variables.
Migrate your configuration
Move a legacy gcx configuration to the version 1 format.
Usage statistics
Understand which statistics gcx reports to Grafana Labs, and what they’re used for.
Keychain credential storage
Learn how gcx stores credentials.
User guides
User guides for dashboards as code, diagnostics, manage resources, and more.