# Install graphql-inspector with Homebrew

Validate schema, get schema change notifications, validate operations, and more. Version 6.0.8 via Homebrew; verified 2026-05-02.

## Install

```sh
sudo av install brew:graphql-inspector
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install graphql-inspector
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:graphql-inspector
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/graphql-inspector>
- **Version:** 6.0.8
- **Source summary:** Validate schema, get schema change notifications, validate operations, and more
- **Homepage:** <https://the-guild.dev/graphql/inspector>
- **Repository:** <https://github.com/graphql-hive/graphql-inspector>
- **Upstream docs:** <https://the-guild.dev/graphql/inspector/docs>
- **License:** MIT
- **Source archive:** <https://registry.npmjs.org/@graphql-inspector/cli/-/cli-6.0.8.tgz>
- **Last updated:** 2026-05-02T04:18:19Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- graphql-inspector (cli)
- graphql-inspector (alias)

## Dependencies

- node

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 6.0.8
- Package-manager updated: 2026-05-02
- Local data: ok
- Upstream repository: https://the-guild.dev/graphql/inspector
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

GraphQL Inspector is a suite of schema-management tools for GraphQL APIs. It compares schemas, classifies schema changes, validates operations and fragments, reports coverage, finds duplicate or similar types, and exposes those capabilities through a CLI, GitHub Action, and programmatic API.

Its package identity is strongly tied to CI: it turns GraphQL schema evolution into something package users can check before merge, rather than discovering broken operations at runtime.

### Project history

The Guild introduced GraphQL Inspector as part of its broader GraphQL tool stack after building Angular Apollo, GraphQL Code Generator, and GraphQL Modules. The introductory article described it as a tool for keeping a GraphQL API and its clients well developed, with schema comparison, schema coverage, operation validation, and GitHub integration.

The GitHub README and documentation kept the same core pitch: compare two schemas, explain each change as breaking, non-breaking, or dangerous, validate documents and fragments, and find similar or duplicated types. The project later moved under the graphql-hive GitHub organization while remaining part of The Guild's GraphQL tool family.

Over time GraphQL Inspector split functionality into packages such as core, cli, action, diff-command, validate-command, coverage-command, and loaders. That packaging model mirrors the tool's purpose: users can install the CLI for all features, the CI-focused packages for smaller automation, or the core API to build custom tooling.

### Adoption history

GraphQL Inspector gained traction where GraphQL schemas are versioned in Git and teams want pull requests to show API impact. The GitHub Action documentation describes checks that compare pull-request schema changes against a branch and annotate changes in code review.

The continuous-integration documentation emphasizes schema diffing as the common case and breaks features into installable commands and loaders for `.graphql` files, code files, JSON introspection, Git, GitHub, and GraphQL endpoints. This made the tool fit both monorepo and service-oriented workflows.

Its adoption also benefited from The Guild ecosystem. GraphQL CLI 4.1 named GraphQL Inspector alongside GraphQL Code Generator as a recommended workflow for production GraphQL applications, placing Inspector in a larger toolchain rather than as a one-off checker.

### How it is used

The CLI is installed as `@graphql-inspector/cli` with the `graphql` peer dependency and run as `graphql-inspector`. Common commands include `diff`, `validate`, `coverage`, `similar`, `introspect`, and `serve`.

CI users often run `graphql-inspector diff` between a schema in Git and the schema produced by a branch. The GitHub Action variant can annotate changes and fail a pull request on breaking changes unless the workflow configuration allows them.

Programmatic users import functions such as `diff`, `validate`, and `coverage` from `@graphql-inspector/core`, which makes the tool useful inside custom release gates, dashboards, and registry-like workflows.

### Why package nerds care

GraphQL Inspector is a canonical example of GraphQL's schema-as-contract packaging problem. The package is not about serving requests; it is about preventing downstream clients from being surprised by schema changes.

Its split package layout is also package-nerd bait: core library, CLI, CI variant, action bundle, command packages, and loader packages all map neatly to different install sizes and automation targets.

For Homebrew users, it packages a JavaScript GraphQL CI tool as a system-level executable, which is handy for teams that prefer reproducible shell tooling outside per-project `node_modules`.

### Timeline

- 2019: The Guild introduced GraphQL Inspector with schema comparison, coverage, validation, and GitHub integration.
- 2020: The Guild published additional GraphQL Inspector guidance around remote control, environments, CI, schema notifications, and upcoming features.
- 2020: GraphQL CLI 4.1 included GraphQL Inspector as part of recommended GraphQL development workflows.
- 2020s: The project evolved into a multi-package tool with CLI, CI, Action, loaders, and core API packages.

### Related projects

- GraphQL Hive is the adjacent schema registry and monitoring project promoted in the GraphQL Inspector README.
- GraphQL Code Generator often appears in the same workflow because one tool checks schema changes while the other generates typed client or server artifacts.
- GraphQL CLI integrated Inspector features and helped position it as part of a broader GraphQL developer workflow.
- Ruby's GraphQL Schema Comparator is named in the README as a source from which part of the library was ported.

### Sources

- <https://github.com/graphql-hive/graphql-inspector>
- <https://github.com/graphql-hive/graphql-inspector/releases>
- <https://medium.com/the-guild/graphql-inspector-481c1a5ef616>
- <https://the-guild.dev/graphql/hive/blog/whats-new-in-graphql-cli-4.1.0>
- <https://the-guild.dev/graphql/inspector/docs>
- <https://the-guild.dev/graphql/inspector/docs/installation>
- <https://the-guild.dev/graphql/inspector/docs/products/action>
- <https://the-guild.dev/graphql/inspector/docs/products/ci>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** graphql-inspector
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew.
- [graphqlviz](https://www.automicvault.com/pkg/brew/graphqlviz/) - Shares av.db curated category or tags: api, cli, developer-tools, graphql.
- [graphqxl](https://www.automicvault.com/pkg/brew/graphqxl/) - Shares av.db curated category or tags: api, cli, developer-tools, graphql.
- [graphqurl](https://www.automicvault.com/pkg/brew/graphqurl/) - Shares av.db curated category or tags: api, cli, developer-tools, graphql.
- [graphql-cli](https://www.automicvault.com/pkg/brew/graphql-cli/) - Shares av.db curated category or tags: cli, developer-tools, graphql.
- [httpie](https://www.automicvault.com/pkg/brew/httpie/) - Shares av.db curated category or tags: api, cli, developer-tools.
- [httpyac](https://www.automicvault.com/pkg/brew/httpyac/) - Shares av.db curated category or tags: api, cli, developer-tools, graphql.
- [rover](https://www.automicvault.com/pkg/brew/rover/) - Shares av.db curated category or tags: cli, developer-tools, graphql.
- [ain](https://www.automicvault.com/pkg/brew/ain/) - Shares av.db curated category or tags: api, cli, developer-tools.

## Combined YAML source

View the package source record on GitHub. [combined/graphql-inspector.yml](https://github.com/automic-vault/db/blob/main/combined/graphql-inspector.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
