github.com/grafana/gcx
v1.1.0
#2354 most downloaded on Go modules
grafana/gcx
What this package is like to depend on
Last release 3 days ago
20 Aug 2026
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 28 of 28 stable releases
Nothing withdrawn
no release was ever pulled
4 months old
76 releases · first in 2026
76 releases in the last 12 months
see the full history below
Release timeline
76 releases · Mar 2026 to Aug 2026Releases
latest 60 of 76-
v1.1.1-0.20260820192314-2ceeb16a02b220 Aug 2026 pre-releaseNothing published for this version
-
v1.1.1-0.20260814143643-ebfdc4c0479514 Aug 2026 pre-releaseNothing published for this version
-
v1.1.014 Aug 2026Release notes
Open source →Breaking changes
gcx agento11y collections add-conversationsandgcx agento11y collections remove-conversationemittype: gcx.agento11y.collection_membershipinstead ofgcx.aio11y.collection_membership.schema_versionstays1. No fields changed. Scripts that readtypemust accept the new value.
New features
- Add
gcx profiles data-rangefor Pyroscope ingestion health. - Add the same
data-rangecommand undergcx datasources pyroscope. - Add
gcx instrumentation explainandlist-explanationsfor the finding explanations that ship withotel-checker(now v0.3.1). - Add an
EXPLAIN_IDcolumn togcx instrumentation checktable output, and anexplain_idfield to its JSON output. Pass the value togcx instrumentation explain. - Add
gcx assistant investigations list-evidence. - Show the chat ID next to the investigation ID in
investigations get. - Keep full v2 investigation summaries and totals in list output.
- Filter IRM alert groups by escalation chain and by date window.
- Add agent support to
gcx metrics list-names. - Add agent support to metrics label matching.
Improvements
- Check contexts concurrently in
gcx config check. - Record
target_kindin usage telemetry events.
Fixes
- Make
gcx dev serveexit on Ctrl-C. - Set
AllowsEditsso gcx-managed dashboards stay editable in the UI. - Keep
configTypein Fleet so OTel pipelines round-trip. - Support UTF-8 label names in profiles.
- Match experiment report types and trial counts to the API.
- Send guard redaction config as
redactwith{id, regex}. - Drop
rule_idfrom the rules update PATCH body. - Handle an unavailable keychain safely during verification.
Internal
- Rename the
aio11yGo package toagento11y. - Add the
integrate-with-gcxandreview-prcontributor skills. - Add a command naming conventions guide.
- Restructure the Grafana Cloud documentation.
- Pin
GCX_AGENT_MODE=falsefor the test tasks. - Add data sources code owners for
internal/datasources.
Release notes
Open source →Breaking changes
gcx agento11y collections add-conversationsandgcx agento11y collections remove-conversationemittype: gcx.agento11y.collection_membershipinstead ofgcx.aio11y.collection_membership.schema_versionstays1. No fields changed. Scripts that readtypemust accept the new value.
New features
- Add
gcx profiles data-rangefor Pyroscope ingestion health. - Add the same
data-rangecommand undergcx datasources pyroscope. - Add
gcx instrumentation explainandlist-explanationsfor the finding explanations that ship withotel-checker(now v0.3.1). - Add an
EXPLAIN_IDcolumn togcx instrumentation checktable output, and anexplain_idfield to its JSON output. Pass the value togcx instrumentation explain. - Add
gcx assistant investigations list-evidence. - Show the chat ID next to the investigation ID in
investigations get. - Keep full v2 investigation summaries and totals in list output.
- Filter IRM alert groups by escalation chain and by date window.
- Add agent support to
gcx metrics list-names. - Add agent support to metrics label matching.
Improvements
- Check contexts concurrently in
gcx config check. - Record
target_kindin usage telemetry events.
Fixes
- Make
gcx dev serveexit on Ctrl-C. - Set
AllowsEditsso gcx-managed dashboards stay editable in the UI. - Keep
configTypein Fleet so OTel pipelines round-trip. - Support UTF-8 label names in profiles.
- Match experiment report types and trial counts to the API.
- Send guard redaction config as
redactwith{id, regex}. - Drop
rule_idfrom the rules update PATCH body. - Handle an unavailable keychain safely during verification.
Internal
- Rename the
aio11yGo package toagento11y. - Add the
integrate-with-gcxandreview-prcontributor skills. - Add a command naming conventions guide.
- Restructure the Grafana Cloud documentation.
- Pin
GCX_AGENT_MODE=falsefor the test tasks. - Add data sources code owners for
internal/datasources.
-
v1.0.1-0.20260813131436-d31e00b75b4013 Aug 2026 pre-releaseNothing published for this version
-
v1.0.1-0.20260805171018-d85236fddfd205 Aug 2026 pre-releaseNothing published for this version
-
v1.0.1-0.20260805141756-c516236a6bdb05 Aug 2026 pre-releaseNothing published for this version
-
v1.0.1-0.20260731143634-07be5700c3fb31 Jul 2026 pre-releaseNothing published for this version
-
v1.0.1-0.20260728135205-32dcfcad14c428 Jul 2026 pre-releaseNothing published for this version
-
v1.0.028 Jul 2026Release notes
Open source →Features
- alert: add ruler subtree for datasource-managed rule writes
- kg: add
entities correlateto resolve entities from alert labels - kg: add entity quality reports (
kg quality), folded intokg diagnose
Fixes
- alert: make GMA alert rules modifiable via the resources tier
- cloud: drop status/createdAt/updatedAt from stack regions output
- aio11y: point plugin id at renamed grafana-agento11y-app
Docs
- GA: remove public preview warnings, add GA notes across docs and README
- skills: harden agento11y-instrument and agento11y-prod-setup guidance
- stop prescribing Editor/Admin for service-account tokens; installation fixes
Release notes
Open source →Features
- alert: add ruler subtree for datasource-managed rule writes
- kg: add
entities correlateto resolve entities from alert labels - kg: add entity quality reports (
kg quality), folded intokg diagnose
Fixes
- alert: make GMA alert rules modifiable via the resources tier
- cloud: drop status/createdAt/updatedAt from stack regions output
- aio11y: point plugin id at renamed grafana-agento11y-app
Docs
- GA: remove public preview warnings, add GA notes across docs and README
- skills: harden agento11y-instrument and agento11y-prod-setup guidance
- stop prescribing Editor/Admin for service-account tokens; installation fixes
-
v0.6.1-0.20260727094134-86a5ce01d66d27 Jul 2026 pre-releaseNothing published for this version
-
v0.6.024 Jul 2026Release notes
Open source →Breaking changes
- Naming convergence: verb-first subcommand renames across all providers
(e.g.versions→list-versions,create→upsert,summary→stats) - Config split into separate stacks, cloud entries, and contexts (auto-migrates)
- Agent output contract: one JSON document per finite command
- Profiles:
profile-typesrenamed tolist-profile-typesat both mounts - Alert: dropped
create/update/applyaliases from templatesupsert
Features
- Telemetry: first-run notice and default-on anonymous usage stats
- Output: list truncation contract with honest caps and agent-legible metadata
- aio11y: experiments v2 shapes and commands, plus conversation annotations
- kg:
--dry-runfor model-rules and prom-rules upsert - Profiles: time-range flags for
labelsandlist-profile-types
Fixes
- Cloud: stop misreporting invalid stack slugs as "slug already taken"
- appo11y: honor
--configacross the direct command tree - aio11y: honor
--configin direct agento11y CRUD commands - irm: decode expanded webhook integration filters
Docs
- Added anonymous usage statistics page; fixed usage-stats command examples
Release notes
Open source →Breaking changes
- Naming convergence: verb-first subcommand renames across all providers
(e.g.
versions→list-versions,create→upsert,summary→stats) - Config split into separate stacks, cloud entries, and contexts (auto-migrates)
- Agent output contract: one JSON document per finite command
- Profiles:
profile-typesrenamed tolist-profile-typesat both mounts - Alert: dropped
create/update/applyaliases from templatesupsert
Features
- Telemetry: first-run notice and default-on anonymous usage stats
- Output: list truncation contract with honest caps and agent-legible metadata
- aio11y: experiments v2 shapes and commands, plus conversation annotations
- kg:
--dry-runfor model-rules and prom-rules upsert - Profiles: time-range flags for
labelsandlist-profile-types
Fixes
- Cloud: stop misreporting invalid stack slugs as "slug already taken"
- appo11y: honor
--configacross the direct command tree - aio11y: honor
--configin direct agento11y CRUD commands - irm: decode expanded webhook integration filters
Docs
- Added anonymous usage statistics page; fixed usage-stats command examples
- Naming convergence: verb-first subcommand renames across all providers
-
v0.5.1-0.20260723164805-1ffe1f6868d023 Jul 2026 pre-releaseNothing published for this version
-
v0.5.021 Jul 2026Release notes
Open source →- Register the Assistant as a first-class provider, moving
mcp-serversinto the resources pipeline - Breaking: rename the
aio11ycommand tree and skills toagento11y - Breaking: rename the
agento11y-eval-starterskill toagento11y-test-starter - Add
agento11y-instrumentskill (setup → instrument → verify loop) - Add
agento11y-prod-setupskill for production evals and guards - Bundle the
agento11y-test-starterstarter skill - Breaking: remove the
explore-datasourcesskill - Retune skill descriptions and fix API drift in aio11y, SLO, and Synthetics guidance
- Export anonymous usage events as flat JSON over HTTP when telemetry is enabled
- Add profiles span and trace selectors; include trace IDs in exemplars
- Fix profiles
--toptotals to exclude the pre-window boundary point - Add KG
prom-rules schemacommand and--dry-runto suppressions create - Route KG write API through the Asserts plugin proxy
- Fix KG entity/relationship deletes to use the collection-path API
- Support Dashboard V2 in the resource linter
- Descend into single-key list envelopes for
--jsondiscovery and selection - Include an output-shape hint in
--jqruntime errors - Request full cloud scopes in the
login cloudfollowup flow - Derive SDK imports for generated
dev importcode from actual usage - Disclose per-product Grafana Cloud costs in docs and help text
- Clarify gcx works with OSS and Enterprise, not just Cloud
- Mark the traces
--llmflag experimental and document its Accept header
Release notes
Open source →- Register the Assistant as a first-class provider, moving
mcp-serversinto the resources pipeline - Breaking: rename the
aio11ycommand tree and skills toagento11y - Breaking: rename the
agento11y-eval-starterskill toagento11y-test-starter - Add
agento11y-instrumentskill (setup → instrument → verify loop) - Add
agento11y-prod-setupskill for production evals and guards - Bundle the
agento11y-test-starterstarter skill - Breaking: remove the
explore-datasourcesskill - Retune skill descriptions and fix API drift in aio11y, SLO, and Synthetics guidance
- Export anonymous usage events as flat JSON over HTTP when telemetry is enabled
- Add profiles span and trace selectors; include trace IDs in exemplars
- Fix profiles
--toptotals to exclude the pre-window boundary point - Add KG
prom-rules schemacommand and--dry-runto suppressions create - Route KG write API through the Asserts plugin proxy
- Fix KG entity/relationship deletes to use the collection-path API
- Support Dashboard V2 in the resource linter
- Descend into single-key list envelopes for
--jsondiscovery and selection - Include an output-shape hint in
--jqruntime errors - Request full cloud scopes in the
login cloudfollowup flow - Derive SDK imports for generated
dev importcode from actual usage - Disclose per-product Grafana Cloud costs in docs and help text
- Clarify gcx works with OSS and Enterprise, not just Cloud
- Mark the traces
--llmflag experimental and document its Accept header
- Register the Assistant as a first-class provider, moving
-
v0.4.5-0.20260717154515-0f92fb07d53017 Jul 2026 pre-releaseNothing published for this version
-
v0.4.5-0.20260713065025-a666b533ff1c13 Jul 2026 pre-releaseNothing published for this version
-
v0.4.410 Jul 2026Release notes
Open source →- Add full CRUD lifecycle for datasources (create, update, delete, health, schemas)
- Add
--namefilter todatasources list - Parallelize per-plugin-group datasource list fetch for speed
- Add CRUD verbs and discovery for IRM OnCall resources
- Fix IRM build break from a semantic merge conflict
- Add OAuth login flow for
gcx cloud login(grafana.com), marked experimental - Expand OAuth scopes; drop k6 from write scopes; fix login help text/doc links
- Add anonymous usage stats core library (telemetry, not yet wired in)
- Add fail-safe client-side dry-run for APIs that ignore
dryRun - Add metrics cardinality analysis commands
- Add filter, group-by, and label discovery to appo11y services commands
- Add
assistant mcp-serverscommand group - Add knowledge graph entity & relationship write commands (gated, experimental)
- Add
x-client-idheader to Synthetic Monitoring requests - Fix logs: distinguish structured metadata from indexed stream labels
- Skip
/bootdatanamespace validation when stack-id is set (faster config load) - Dedupe HTTP client construction/error parsing across providers
- Dedupe Prometheus/Loki/CloudWatch onto shared query transport
- Dedupe aio11y marshal/status-check/decode pattern
- Dedupe datasources config-loading boilerplate
- Add drift check ensuring bundled skills match real gcx commands
- Switch lint to Go module mode, dropping the
vendor/requirement - Update Go dependencies
- Fix docs links in README, CLI help text, and OAuth login docs
- Use main branch for deploy previews; update SM CODEOWNERS
Release notes
Open source →- Add full CRUD lifecycle for datasources (create, update, delete, health, schemas)
- Add
--namefilter todatasources list - Parallelize per-plugin-group datasource list fetch for speed
- Add CRUD verbs and discovery for IRM OnCall resources
- Fix IRM build break from a semantic merge conflict
- Add OAuth login flow for
gcx cloud login(grafana.com), marked experimental - Expand OAuth scopes; drop k6 from write scopes; fix login help text/doc links
- Add anonymous usage stats core library (telemetry, not yet wired in)
- Add fail-safe client-side dry-run for APIs that ignore
dryRun - Add metrics cardinality analysis commands
- Add filter, group-by, and label discovery to appo11y services commands
- Add
assistant mcp-serverscommand group - Add knowledge graph entity & relationship write commands (gated, experimental)
- Add
x-client-idheader to Synthetic Monitoring requests - Fix logs: distinguish structured metadata from indexed stream labels
- Skip
/bootdatanamespace validation when stack-id is set (faster config load) - Dedupe HTTP client construction/error parsing across providers
- Dedupe Prometheus/Loki/CloudWatch onto shared query transport
- Dedupe aio11y marshal/status-check/decode pattern
- Dedupe datasources config-loading boilerplate
- Add drift check ensuring bundled skills match real gcx commands
- Switch lint to Go module mode, dropping the
vendor/requirement - Update Go dependencies
- Fix docs links in README, CLI help text, and OAuth login docs
- Use main branch for deploy previews; update SM CODEOWNERS
-
v0.4.4-0.20260705005855-07fa8b09a48a05 Jul 2026 pre-releaseNothing published for this version
-
v0.4.301 Jul 2026Release notes
Open source →- Query: fall back to
/api/ds/queryon any non-200 from the k8s query API - Pyroscope: default the metrics query step from the datasource config
- Knowledge Graph: apply the selected time range to entity scopes lookup
- Agent mode: mark cloud-only commands via new
agent.availabilityannotation - Windows: open OAuth browser via
explorer.exeso the login URL survives - CI: auto-publish the Homebrew formula and drop dead docs jobs
Release notes
Open source →- Query: fall back to
/api/ds/queryon any non-200 from the k8s query API - Pyroscope: default the metrics query step from the datasource config
- Knowledge Graph: apply the selected time range to entity scopes lookup
- Agent mode: mark cloud-only commands via new
agent.availabilityannotation - Windows: open OAuth browser via
explorer.exeso the login URL survives - CI: auto-publish the Homebrew formula and drop dead docs jobs
- Query: fall back to
-
v0.4.229 Jun 2026Release notes
Open source →- Add Athena datasource provider (query, list catalogs/databases/tables, describe-table)
- Introduce shared SQL query package, refactoring ClickHouse onto it
- Synthetic Monitoring now syncs via a Grafana datasource proxy client
- Set X-Grafana-Caller-Id header on all datasource queries
- Refine output formatting (format and jq handling)
- Remove obsolete publish-technical-documentation workflows
Release notes
Open source →- Add Athena datasource provider (query, list catalogs/databases/tables, describe-table)
- Introduce shared SQL query package, refactoring ClickHouse onto it
- Synthetic Monitoring now syncs via a Grafana datasource proxy client
- Set X-Grafana-Caller-Id header on all datasource queries
- Refine output formatting (format and jq handling)
- Remove obsolete publish-technical-documentation workflows
-
v0.4.124 Jun 2026Release notes
Open source →- Breaking:
--log-http-payloadhas been renamed to--insecure-log-http-payload. The old flag name now exits with an error naming the replacement. Payload-dump behavior is unchanged — credentials, cookies, OAuth refresh tokens, and request bodies still appear in the dump when the flag is set. A startup warning is now printed to stderr when the flag is active. - Breaking:
gcx dev serve --addressnow defaults to127.0.0.1(loopback) instead of0.0.0.0. Users who need LAN or remote access should pass--address 0.0.0.0explicitly. The WebSocket livereload endpoint now rejects cross-origin requests from hosts other thanlocalhost,127.0.0.1,[::1], or the configured listen address. - Soft-breaking: Custom Rego rules loaded via
gcx dev lint --rulescan no longer callhttp.send, anynet.*builtin, oropa.runtime. No flag is provided to re-enable them. Bundled rules are unaffected. - Added
--jqfor inline JSON transformation and improved agent-mode hints. - Added OAuth login support for agent and non-interactive workflows.
- Improved config performance with lazy keychain checks and StackID caching.
- Moved stack management under the
gcx cloud stackscommand group. - Added App O11y service list, get, map, and operation breakdown commands.
- Added Instrumentation Hub
gcx instrumentation checkdiagnostics. - Expanded Assistant investigations with Lodestone v2 capability detection.
- Expanded Knowledge Graph diagnose, meta metrics, and model-rules support.
- Improved IRM incident filtering, paging, and OnCall escalation output.
- Added metrics instant-query timestamps and richer Tempo tag-value output.
- Hardened local debug surfaces and JSON error output for agent workflows.
Release notes
Open source →- Breaking:
--log-http-payloadhas been renamed to--insecure-log-http-payload. The old flag name now exits with an error naming the replacement. Payload-dump behavior is unchanged — credentials, cookies, OAuth refresh tokens, and request bodies still appear in the dump when the flag is set. A startup warning is now printed to stderr when the flag is active. - Breaking:
gcx dev serve --addressnow defaults to127.0.0.1(loopback) instead of0.0.0.0. Users who need LAN or remote access should pass--address 0.0.0.0explicitly. The WebSocket livereload endpoint now rejects cross-origin requests from hosts other thanlocalhost,127.0.0.1,[::1], or the configured listen address. - Soft-breaking: Custom Rego rules loaded via
gcx dev lint --rulescan no longer callhttp.send, anynet.*builtin, oropa.runtime. No flag is provided to re-enable them. Bundled rules are unaffected. - Added
--jqfor inline JSON transformation and improved agent-mode hints. - Added OAuth login support for agent and non-interactive workflows.
- Improved config performance with lazy keychain checks and StackID caching.
- Moved stack management under the
gcx cloud stackscommand group. - Added App O11y service list, get, map, and operation breakdown commands.
- Added Instrumentation Hub
gcx instrumentation checkdiagnostics. - Expanded Assistant investigations with Lodestone v2 capability detection.
- Expanded Knowledge Graph diagnose, meta metrics, and model-rules support.
- Improved IRM incident filtering, paging, and OnCall escalation output.
- Added metrics instant-query timestamps and richer Tempo tag-value output.
- Hardened local debug surfaces and JSON error output for agent workflows.
- Breaking:
-
v0.4.1-0.20260619104858-87d2b276ca2a19 Jun 2026 pre-releaseNothing published for this version
-
v0.4.1-0.20260618084325-761128aa443018 Jun 2026 pre-releaseNothing published for this version
-
v0.4.1-0.20260611125145-74fff38ba3e811 Jun 2026 pre-releaseNothing published for this version
-
v0.4.1-0.20260605230247-9f5025b381f105 Jun 2026 pre-releaseNothing published for this version
-
v0.4.1-0.20260603161010-f28846fc9abd03 Jun 2026 pre-releaseNothing published for this version
-
v0.4.002 Jun 2026Release notes
Open source →- Added
gcx assistant conversation listandgcx assistant conversation getto inspect Assistant conversations and transcripts. - Added support for continuing accessible non-CLI Assistant conversations by context ID, with a warning when the source is not CLI.
- Added automatic migration of token-shaped config secrets into the OS keychain, with plaintext fallback when the keychain is unavailable.
- Breaking: renamed
gcx kg rulestogcx kg prom-rulesto align withmodel-rulesandrelabel-rules. - Added read-only
gcx kg relabel-rules getfor prologue, epilogue, and generated rule groups. - Fixed
kg diagnoseverdicts so failing checks no longer report a healthy service, and reclassify scoped no-data checks as label-scope warnings when unscoped data exists. - Shared Grafana datasource query transport and dataframe wire types across ClickHouse, InfluxDB, and Infinity clients.
- Hardened Claude GitHub Actions secret handling by scoping Vault outputs and restricting
@claudetriggers to trusted repository associations. - Improved agent guidance for dashboard workflows and Tempo trace analysis, including recommending
gcx traces get --llm -o jsonfor full-trace analysis. - Removed several small direct dependencies in favor of internal implementations.
Release notes
Open source →- Added
gcx assistant conversation listandgcx assistant conversation getto inspect Assistant conversations and transcripts. - Added support for continuing accessible non-CLI Assistant conversations by context ID, with a warning when the source is not CLI.
- Added automatic migration of token-shaped config secrets into the OS keychain, with plaintext fallback when the keychain is unavailable.
- Breaking: renamed
gcx kg rulestogcx kg prom-rulesto align withmodel-rulesandrelabel-rules. - Added read-only
gcx kg relabel-rules getfor prologue, epilogue, and generated rule groups. - Fixed
kg diagnoseverdicts so failing checks no longer report a healthy service, and reclassify scoped no-data checks as label-scope warnings when unscoped data exists. - Shared Grafana datasource query transport and dataframe wire types across ClickHouse, InfluxDB, and Infinity clients.
- Hardened Claude GitHub Actions secret handling by scoping Vault outputs and restricting
@claudetriggers to trusted repository associations. - Improved agent guidance for dashboard workflows and Tempo trace analysis, including recommending
gcx traces get --llm -o jsonfor full-trace analysis. - Removed several small direct dependencies in favor of internal implementations.
- Added
-
v0.3.1-0.20260618081835-5f287ca9683618 Jun 2026 pre-releaseNothing published for this version
-
v0.3.1-0.20260527192149-33d1c41e249327 May 2026 pre-releaseNothing published for this version
-
v0.3.1-0.20260527091307-f2bc232ad46327 May 2026 pre-releaseNothing published for this version
-
v0.3.026 May 2026Release notes
Open source →- Added ClickHouse, CloudWatch, and Infinity datasource providers.
- Added richer IRM OnCall alert groups and SRE triage tooling.
- Added a create-dashboard skill and dashboard list --limit flag.
- Improved KG diagnosis for trace propagation and split environments.
- Fixed KG rule list/get/delete calls to match the backend API.
- Added dual k6 client support for OAuth and service-account tokens.
- Fixed k6 provider support for OAuth login.
- Made aio11y experiment cancellation require confirmation.
- Warn when API responses return HTML instead of JSON.
- Exit cleanly on Ctrl+C without noisy errors.
- Normalized dashboard snapshot time ranges.
- Removed target-valid-logql rule to restore go install compatibility.
- Updated login help and Homebrew publishing.
-
v0.2.17-0.20260522203517-7a9059c73a7422 May 2026 pre-releaseNothing published for this version
-
v0.2.17-0.20260521132924-41c5528dc06121 May 2026 pre-releaseNothing published for this version
-
v0.2.1621 May 2026Release notes
Open source →- Add
aio11y experimentscommand group for managing evaluation experiments - Add
aio11y guardssubcommand for managing hook rules - Fix
kg insightschart and sources request/response schemas - Fix
k6token piping warning to reference the correct command - Centralize signal command wiring across metrics, logs, traces, and profiles
- Consolidate error types into
internal/gcxerrors, removingfailshims - Surface
diagnose-entity-graphand document how skills get invoked - Mint Homebrew tap App token via broker in release workflow
- Replace Dependabot with Renovate for dependency updates
- Update Go module dependencies
- Add
-
v0.2.16-0.20260520112926-f1590022d07720 May 2026 pre-releaseNothing published for this version
-
v0.2.16-0.20260519125608-abba1ca5425519 May 2026 pre-releaseNothing published for this version
-
v0.2.1518 May 2026Release notes
Open source →- New:
gcx instrumentationcommand tree — clusters, services, setup, status - New: InfluxDB datasource provider
- New:
gcx irm incidents contexts listcommand - New: Knowledge Graph
diagnosecommand - Profiles query: add
--profile-idand--stacktrace-selectorflags - Profiles query: add pprof output format
- Profiles query: hint at
profile-typescommand in--profile-typehelp - Breaking: rename
kg healthtokg summarywith restructured output - Breaking: remove duplicate
kg scopescommand (usekg entities scopes) - Breaking: remove UI-centric
kg insightsquery/summary/graph commands - Breaking: move
cypherunderkg entities cypher - Breaking: unify insight filtering under
kg entities list --insight - Surface propagated assertions in
kg entities list - Add insight filter flags to
kg entities inspect - Improve
kg entitieshelp text and surface scope props in schema - Fix
kg insights searchendpoint to/v1/assertions/search - Fix
config use-contextto write to the right file when a local.gcx.yamlis loaded - Fix
loginto derive context name from--serverwhen no name is given - Fix datasource kind normalization to recognize Prometheus flavor plugins
- Eliminate redundant datasource GET after auto-discovery
- Include valid values in enum-shaped error messages
- Remove superseded
gcx setup instrumentationsubtree - Refactor pyroscope query to use Options pattern
- Docs: document
--timeflag for instant queries onexplore-datasources - Docs: add manifest examples to
gcx irm incidents create - Docs: move mounting docs to public documentation; fix broken anchor
- Add CODEOWNERS with product team co-ownership
- Add docs sync to the website repo on merge to main
- New:
-
v0.2.15-0.20260513121030-3f1d3d810ce313 May 2026 pre-releaseNothing published for this version
-
v0.2.15-0.20260512232926-b956618196cb12 May 2026 pre-releaseNothing published for this version
-
v0.2.15-0.20260512112221-eb29f45bbb8b12 May 2026 pre-releaseNothing published for this version
-
v0.2.15-0.20260511221055-f135d4c23b7f11 May 2026 pre-releaseNothing published for this version
-
v0.2.15-0.20260511082816-85e6036d877311 May 2026 pre-releaseNothing published for this version
-
v0.2.1409 May 2026Release notes
Open source →- New: Instrumentation Hub provider package with full CRUD, RMW, and Helm formatter support
- New: Alert provisioning CRUD — contact-points, mute-timings, notification-policies, and templates
- New: AI Observability saved-conversations and collections commands
- New:
gcx versionstructured subcommand with machine-readable output - New:
gcx assistant dashboardsubcommand; fix--agent-idflag - New: Login accepts
--org-idto configure organization ID - Knowledge Graph entities list now supports pagination
- Knowledge Graph inspect drops hardcoded filters for raw, agent-friendly output
- Agents codec with temp-file spill for token-efficient agent output
- Log failed agent invocations to disk for capability-gap analysis
- Fix exit codes: usage errors emit 2, partial failures emit 4
stacks delete: rename--yesto--force; respect agent mode- Migrate all provider delete commands to consistent
ConfirmDestructive - Fix non-interactive confirmation bypass for metrics adaptive and alert
- Config check now classifies
.grafana.comhosts and stack-id as Cloud - Login now suggests running
config checkafter successful login - Fix IRM incident URL template to use correct OnCall plugin slug
- Dev import: register v1 converters for Folder and Dashboard resources
--json listfield discovery now returns all nested paths recursively (previously limited to top-level + one level ofspec.*). Users relying ongcx resources get --json listorgcx resources schemas --json listwill see a larger field set.
-
v0.2.14-0.20260506191712-226d20b7041e06 May 2026 pre-releaseNothing published for this version
-
v0.2.1306 May 2026Release notes
Open source →Note: This release includes two important bugfixes
- Fix
--dry-runnot being honored in resource delete operations. PR #643. - Fix
--contextflag not applied across all CRUD adapter operations. PR #625.
Update to this version to avoid unintended operations on your Grafana Cloud stack.
Other changes in this release:
- Add
gcx stackscommands: list, get, create, update, delete, regions - Rename
synthprovider tosynthetic-monitoring - Render trace trees as a formatted table in
gcx traces get - Add RCA Workbench deep link to
gcx kg entities inspect - Consolidate Knowledge Graph insights filtering into
kg entities list - Prevent env var secrets from being written to the config file
- Handle read-only files gracefully during skill updates
- Update agent skills to remove common usage errors
- Bump Go module and GitHub Actions dependencies
- Fix
-
v0.2.1204 May 2026Release notes
Open source →- Dashboards: new CRUD, search, and version history provider
- Dashboards: dev server syncs variable params to URL and restores on refresh
- Knowledge Graph: add
suppressions listandsuppressions deletecommands - Knowledge Graph: fix suppressions overwrite bug
- Knowledge Graph: replace
kg inspectwithentities inspect(LLM summary) - Knowledge Graph: align all kg commands to
[noun] [verb]format - Knowledge Graph: improve
entities listusability - Login: support custom OAuth callback port via
--callback-port - Login: bind OAuth callback port before opening browser to avoid race
- Login: step-aware errors during connectivity validation
- Profiles: add exemplars support (
exemplars profileandexemplars span) - Datasources: add Grafana Explore share links for query results
- Notifications: alert users when a new gcx version is available
- Skills: notify users when installed skills have updates
- Assistant: gracefully block commands on self-hosted Grafana instances
- Linter: detect missing title/description on panels in collapsed rows
- Tooling: replace devbox with mise for dev environment setup
-
v0.2.12-0.20260504080507-80c766f3ee4804 May 2026 pre-releaseNothing published for this version
-
v0.2.12-0.20260430105858-0e39a5e7eab330 Apr 2026 pre-releaseNothing published for this version
-
v0.2.12-0.20260429083812-748ba49b578729 Apr 2026 pre-releaseNothing published for this version
-
v0.2.1129 Apr 2026Release notes
Open source →- Add mTLS client certificate authentication for config and login (Teleport)
- Add
kg describecommand for schema, scopes, and telemetry configs - Add
skills updatecommand to update existing installed skills - Fix metrics default view to be usable out of the box
- Fix synthetic monitoring to surface required scopes on register/install failure
- Fix grafana-com instance selector regression
- Fix
config set/unsetto resolve bare paths against the current context - Fix front matter in the debug-with-grafana skill
- Update README with sigil/aio11y rename and restored Compatibility section
- Update Go dependencies, GitHub Actions, and MySQL Docker tag to v9.7
- Remove PyPI publishing job from release CI
-
v0.2.11-0.20260427142542-ebb64ec1714827 Apr 2026 pre-releaseNothing published for this version
-
v0.2.11-0.20260427074344-dc7189e96a5627 Apr 2026 pre-releaseNothing published for this version
-
v0.2.11-0.20260423130049-a2b7225e853b23 Apr 2026 pre-releaseNothing published for this version
-
v0.2.1023 Apr 2026Release notes
Open source →- Replace Homebrew binary cask with source formula for Gatekeeper-free macOS installs
- Add automated workflow to publish Homebrew formula on release
- Update installation docs and README with new Homebrew instructions
-
v0.2.923 Apr 2026Release notes
Open source →- Consolidated
gcx authandgcx configinto a unifiedgcx logincommand - Renamed
gcx sigilcommand and provider togcx aio11y(AI Observability) - Fixed
gcx irmto pass--max-agefilter through to the OnCall backend - Added PyPI publishing to the release workflow
- Bumped Claude plugin version automatically on release
- Added Grafana Cloud API tiers architectural overview to the docs
- Added compatibility matrix to the README
- Consolidated
-
v0.2.9-0.20260423215804-f0975cc4ef2d23 Apr 2026 pre-releaseNothing published for this version
-
v0.2.9-0.20260423213351-b68ca9db621f23 Apr 2026 pre-releaseNothing published for this version
-
v0.2.9-0.20260422153037-5b015efcd66522 Apr 2026 pre-releaseNothing published for this version
-
v0.2.9-0.20260420142731-11d2b6fb8ef520 Apr 2026 pre-releaseNothing published for this version
-
v0.2.820 Apr 2026Release notes
Open source →- Rename
gcx sigilcommand and provider togcx aio11y(AI Observability) - Fix OAuth refresh lockout when running multiple gcx invocations concurrently
- Improve typed API error handling for datasource queries
- Rename OnCall/Incidents references to IRM across docs and CLI
- Default SLO definitions list limit to all results
- Add Homebrew installation support with docs
- Allow login through grafana.com/launch
- Unified CLI UX consistency pass across commands
- Reorganise and clean up README
- Add DatasourceProvider interface and plugin system for datasources
- Add billing subtree and generic series leaf to metrics
- Add --from/--to time range flags to all kg commands
- Validate kg --scope flag values against known scopes
- Remove redundant kg search entities command
- Filter incidents by tags and from/to time range
- Add fleet auth error scopes suggestion
- Add sigil skill to claude-plugin
- Guide agents to use Grafana Assistant for reasoning tasks
- Recognise OPENCODE as an agent mode
- Bump Kubernetes dependencies to v0.35.4 and Docker deps
- Update anthropics/claude-code-action workflow digest
- Rename
-
v0.2.8-0.20260420081019-959b50df7cda20 Apr 2026 pre-releaseNothing published for this version