gcx is a command-line tool that lets people and AI coding agents manage and inspect Grafana Cloud, Enterprise, and open-source instances. It provides access to dashboards, alerts, SLOs, metrics, logs, and traces, with workflows for alert investigation, dashboard management, GitOps, and observability setup. Its catalogue entries provide agent instructions and extensions for using gcx.
Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/grafana/gcxnpx agentmods add skills/grafana/gcx/setup-gcxWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/grafana/gcx/setup-gcx)<a href="https://agentmods.dev/skills/grafana/gcx/setup-gcx"><img src="https://agentmods.dev/badge/skills/grafana/gcx/setup-gcx.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00094 | $0.03549 |
| Opus 5 | $0.00047 | $0.01775 |
| Sonnet 5 | $0.00019 | $0.00710 |
| Haiku 4.5 | $0.00009 | $0.00355 |
Grade C, and why
setup-gcx scanned grade C with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Recursive force deletehighDestructive command
rm -rf with a variable or a broad path is one typo away from removing the wrong tree.
tmp=$(mktemp -d) && git clone --depth 1 https://github.com/grafana/gcx.git "$tmp" && (cd "$tmp" && go install ./cmd/gcx) && rm -rf "$tmp" Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
curl -I https://grafana.example.com/api/health How it starts
The opening of the file, as written. The whole thing — 463 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Setup gcx
Three configuration paths: Grafana Cloud (Path A), on-premise (Path B), and
environment variables for CI/CD (Path C). For the complete config reference
(all config set paths, TLS options, namespace resolution rules, multi-context
patterns), see configuration.md.
Step 0: Install gcx
First, check whether gcx is already installed:
gcx --version
If the command is not found, build it from source. Requires git and a recent Go toolchain:
tmp=$(mktemp -d) && git clone --depth 1 https://github.com/grafana/gcx.git "$tmp" && (cd "$tmp" && go install ./cmd/gcx) && rm -rf "$tmp"
After installing, verify the binary is on PATH:
gcx --version
Configuration Model
gcx uses a context-based configuration model inspired by kubectl's
kubeconfig. One or more layered YAML files (with the user file at
~/.config/gcx/config.yaml by default)
store named stacks (Grafana destination, credentials, provider config), named
cloud entries (Grafana Cloud platform credentials and endpoints), and thin
contexts that reference a stack and optional Cloud entry. One context is
selected at a time; all commands operate against it unless overridden.
Single-source legacy configs are migrated automatically after a safe preflight.
When several layers participate, gcx converts them in memory and asks the user
to migrate each layer explicitly rather than partially persisting the result.
Use gcx config view to inspect the current configuration at any time.
Use gcx config check to validate that the active context is correct
and can reach the server.
Path A: Grafana Cloud
Use this path when connecting to a Grafana Cloud instance
(URLs ending in .grafana.net).
Step 1: Create a stack and context
gcx config set stacks.cloud.grafana.server https://myorg.grafana.net
gcx config set contexts.cloud.stack cloud
Replace cloud with any name you prefer (e.g., prod, myorg-cloud).
Replace the server URL with your Grafana Cloud URL. The first command creates
the stack entry; the second creates a context pointing at it.
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 7d ago First seen · 463 lines · 94 tokens per session scan C 777cc75938ec
setup-gcx is a skill published in the GitHub repository grafana/gcx (587 stars, last pushed yesterday), licensed Apache-2.0. It adds 94 tokens to every session and 3,549 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it C with 2 findings (recursive force delete, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
gke-compute-classes
Configures, optimizes, and troubleshoots GKE ComputeClasses. Use when configuring Spot VMs with on-demand fallback, targeting specific accelerators (GPUs/TPUs) or machine families, restricting ComputeClass access, or debugging pending pods related to node pool auto-creation. Do not use for cluster-level Node Auto…
gke-workload-security
Audits, configures, and hardens workload-level security controls for Google Kubernetes Engine (GKE) applications and namespaces. Covers running cluster security audits (auditcluster.sh), configuring Workload Identity Federation (impersonation, KSA/GSA binding, and pod setup), enforcing Network Policies (default-deny…
gke-reliability
Improves GKE workload reliability, using PDBs, health probes, and topology spread constraints. Use when configuring GKE workload reliability, setting up PDBs, or configuring GKE health probes (liveness, readiness, startup). Don't use for disaster recovery setup or full cluster backups (use gke-backup-dr instead).
nemo-automodel-launcher-config
Configure NeMo AutoModel job launches for interactive runs, Slurm clusters, and SkyPilot cloud execution.
azure-mgmt-botservice-dotnet
Azure Resource Manager SDK for Bot Service in .NET. Management plane operations for creating and managing Azure Bot resources, channels (Teams, DirectLine, Slack), and connection settings. Triggers: "Bot Service", "BotResource", "Azure Bot", "DirectLine channel", "Teams channel", "bot management .NET", "create bot".
cloud-architect
Designs cloud architectures, creates migration plans, generates cost optimization recommendations, and produces disaster recovery strategies across AWS, Azure, and GCP. Use when designing cloud architectures, planning migrations, or optimizing multi-cloud deployments. Invoke for Well-Architected Framework, cost…