OpsCanary
observabilityPractitioner

Unlock Terminal Observability with the gcx CLI Tool

5 min read Grafana BlogReviewed for accuracy
Share
PractitionerHands-on experience recommended

In today's fast-paced development environment, observability is crucial. The gcx CLI tool addresses this need by bringing Grafana Cloud and Grafana Assistant directly into your terminal. This integration allows you to manage observability without the hassle of switching between different interfaces, making it easier to monitor your systems and respond to issues in real-time.

The gcx tool operates across the entire observability lifecycle, covering Instrumentation, Alerting, SLOs, and synthetic checks. It auto-detects when it's being driven by tools like Claude Code or Cursor, eliminating unnecessary human-friendly noise such as spinners and truncation. You can configure it to drop this noise by setting the GCX_AGENT_MODE parameter to true, which can enhance your focus on the critical data. Commands like $ gcx skills list allow you to manage your observability skills directly from the terminal, making it a powerful addition to your toolkit.

As you start using gcx, be aware that it is currently in public preview. This means you might encounter some rough edges or missing features. Make sure to keep an eye on updates and community feedback to get the most out of this tool. Its ability to pull dashboards, alerts, SLOs, and checks as files for local editing can significantly streamline your workflows, but you should also be prepared for potential limitations as it evolves.

Key takeaways

  • Leverage gcx for seamless terminal integration with Grafana Cloud.
  • Use `gcx skills install --all` to quickly set up observability tools.
  • Configure `GCX_AGENT_MODE` to eliminate unnecessary terminal noise.
  • Utilize gcx commands to manage observability without switching contexts.

Why it matters

Effective observability directly impacts your ability to respond to incidents and maintain system reliability. By integrating monitoring into your terminal workflow, you reduce context switching and improve response times.

Code examples

Bash
$ gcx skills install --all
Bash
$ gcx skills list

When NOT to use this

The official docs don't call out specific anti-patterns here. Use your judgment based on your scale and requirements.

Want the complete reference?

Read official docs

Test what you just learned

Quiz questions written from this article

Take the quiz →
Better StackSponsor

Unified observability — logs, uptime monitoring, and on-call in one place. Used by 50,000+ engineering teams to ship faster and sleep better.

Try Better Stack free →

Get the daily digest

One email. 5 articles. Every morning.

No spam. Unsubscribe anytime.