Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/grafana/latest/as-code/observability-as-code/grafana-cli/gcx.md, or by sending Accept: text/markdown to https://grafana.com/docs/grafana/latest/as-code/observability-as-code/grafana-cli/gcx/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
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:
gcxis compatible with any agentic coding tool.gcxworks across a wide range of Grafana product offerings. Feature availability depends on your Grafana deployment. For more information, refer to the Compatibility matrix.gcxis 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
Was this page helpful?
Related resources from Grafana Labs


