Grafana Cloud Enterprise Open source

Overview of the gcx CLI

gcx is a single CLI that ships with a suite of agent skills and allows you and your AI coding agent structured access to both Grafana (dashboards, folders, alert rules, data sources) and Grafana Cloud products such as Synthetic Monitoring, K6, Fleet Management, Incidents, or Adaptive Telemetry. It’s integrated with Grafana Assistant, combining the previously fragmented user experience into one single tool.

gcx is under continuous development. Contact Grafana for support or to report any issues you encounter and help us improve this feature.

Compatibility

The following applies:

  • gcx is compatible with any agentic coding tool.

  • gcx works across a wide range of Grafana product offerings. Feature availability depends on your Grafana deployment. For more information, refer to the Compatibility matrix.

  • gcx is available for Grafana Cloud and Grafana OSS/Enterprise v12 or later, and older Grafana versions are not supported.

Migrate from grafanactl

If you want to migrate from grafanctl to gcx, search-and-replace grafanactl with gcx. For grafanactl resources serve, use gcx dev serve instead.

Learn more

Refer to the documents in this section and the gcx repository in GitHub for more information on:

  • Installation
  • Configuration
  • Migration of your configuration files to v1 format
  • Usage statistics
  • How to manage resources, including dashboards-as-code
  • CLI command reference