gcx

Project Overview

gcx is a CLI for Grafana — Cloud, Enterprise, and OSS alike (Grafana 12+). It gives you and your AI coding agent structured access to your Grafana instance: dashboards, alerts, SLOs, metrics, logs, traces, and more.

Key Features

• Resource management: Dashboards, alerts, SLOs, metrics, logs, traces
• Dashboard operations: gcx dashboards list, gcx dashboards search
• Metric queries: gcx metrics query
• Agent skills suite: Out-of-the-box workflows for alert investigation, dashboard creation and GitOps, SLO management, and observability setup
• Login management: gcx login for Grafana Cloud and self-hosted instances

Target Audience

• Grafana users and administrators
• Developers using AI coding agents
• DevOps and SRE engineers

Quick Start

1. Quick install (Linux/macOS): curl -fsSL https://raw.githubusercontent.com/grafana/gcx/main/scripts/install.sh | sh
2. Or via Homebrew: brew install grafana/grafana/gcx
3. Login to Grafana Cloud: gcx login prod --server https://<instance>.grafana.net
4. Query metrics: gcx metrics query 'sum by (handler)(rate(grafana_http_request_duration_seconds_count[5m]))' --since 1h

Core Advantages

• Optimized for AI agent usage
• Out-of-the-box agent skills suite
• Supports Grafana Cloud, Enterprise, and OSS
• Open-source and free (Apache-2.0)

System Requirements

• OS: Cross-platform (Linux, macOS, Windows)
• Architectures: x86_64, arm64