---
title: "gcx CLI | Grafana documentation"
description: "Use gcx to manage Grafana and Grafana Cloud from the terminal and from agentic coding tools."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# 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](https://github.com/grafana/gcx) in GitHub for the complete set of `gcx` documents, including architecture information, user guides, and other reference material.

[Overview  
\
Overview of the `gcx` CLI.](overview/)

[Installation  
\
Install `gcx` with the quick installer, Homebrew, or a prebuilt binary.](installation/)

[CLI reference  
\
Commands, flags, environment variables, and configuration for the latest stable release.](cli-reference/)

[Configuration  
\
Configure `gcx` with the configuration file or using environment variables.](configuration/)

[Migrate your configuration  
\
Move a legacy `gcx` configuration to the version 1 format.](migrate-configuration/)

[Usage statistics  
\
Understand which statistics `gcx` reports to Grafana Labs, and what they’re used for.](anonymous-usage-statistics/)

[Keychain credential storage  
\
Learn how `gcx` stores credentials.](keychain/)

[User guides  
\
User guides for dashboards as code, diagnostics, manage resources, and more.](guides/)