# graphql-inspector を Homebrew でインストール

graphql-inspector のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。

## インストール

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

追加のインストールコマンド:

### macOS

- Homebrew (100%):

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

  証拠: local Homebrew formula metadata

## パッケージ情報

- **パッケージキー:** brew:graphql-inspector
- **パッケージマネージャ:** Homebrew
- **パッケージマネージャページ:** <https://formulae.brew.sh/formula/graphql-inspector>
- **バージョン:** 6.0.8
- **ソース概要:** Validate schema, get schema change notifications, validate operations, and more
- **ホームページ:** <https://the-guild.dev/graphql/inspector>
- **上流ドキュメント:** <https://the-guild.dev/graphql/inspector>
- **ライセンス:** MIT
- **ソースアーカイブ:** <https://registry.npmjs.org/@graphql-inspector/cli/-/cli-6.0.8.tgz>
- **生成日時:** 2026-08-04T22:13:35+00:00

## 実行可能ファイル

- graphql-inspector (cli)
- graphql-inspector (エイリアス)

## 依存関係

- node

## インストール挙動

- post-install フック: 未定義
- Bottle: 利用可能 対象 all

## バージョンと鮮度

- ページ生成日: 2026-08-04
- マネージャ版: 6.0.8
- ローカルデータ: OK
- 上流リポジトリ: https://the-guild.dev/graphql/inspector
- 情報: No package-manager update timestamp was available.
- 情報: Release/tag comparison is only available for GitHub repositories.
## プロジェクトの歴史と使われ方

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.

### プロジェクトの歴史

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.

### 採用の歴史

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.

### 使われ方

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.

### パッケージ好きにとっての重要性

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`.

### タイムライン

- 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.

### ソース

- <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>


## セキュリティノート

narrow executable package without higher-risk signals.

- **Geiger リスク:** グリーン / 低
- narrow executable package without higher-risk signals

## ソースデータベース詳細

- **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


## 関連リンク

- [Terminal utility packages](https://pkg.so/ja/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/ja/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://pkg.so/ja/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://pkg.so/ja/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [node](https://pkg.so/ja/brew/node/) - Runtime dependency declared by Homebrew.
- [graphqlviz](https://pkg.so/ja/brew/graphqlviz/) - Shares pkgdb curated category or tags: cli, developer-tools, graphql.
- [resterm](https://pkg.so/ja/brew/resterm/) - Shares pkgdb curated category or tags: cli, developer-tools, graphql.
- [rover](https://pkg.so/ja/brew/rover/) - Shares pkgdb curated category or tags: cli, developer-tools, graphql.
- [schemathesis](https://pkg.so/ja/brew/schemathesis/) - Shares pkgdb curated category or tags: cli, developer-tools, graphql.
- [quicktype](https://pkg.so/ja/brew/quicktype/) - Shares pkgdb curated category or tags: cli, developer-tools, graphql.
- [calm-cli](https://pkg.so/ja/brew/calm-cli/) - Shares pkgdb curated category or tags: cli, developer-tools, schema-validation.
- [httpyac](https://pkg.so/ja/brew/httpyac/) - Shares pkgdb curated category or tags: cli, developer-tools, graphql.
- [graphql-cli](https://pkg.so/ja/brew/graphql-cli/) - Shares pkgdb curated category or tags: cli, developer-tools, graphql.

## Combined YAML source

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


## ソース

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- cross-ecosystem install command graph
