# 使用 Homebrew 安装 graphql-inspector 查看 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 - **版本:** 6.0.8 - **来源摘要:** Validate schema, get schema change notifications, validate operations, and more - **主页:** - **已生成:** 2026-08-03T19:37:03+00:00 ## 可执行文件 - graphql-inspector (别名) ## 安装行为 - Bottle: 不可用 ## 版本和新鲜度 - 页面生成时间: 2026-08-03 - 管理器版本: 6.0.8 ## 项目历史与用法 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. ### 来源 - - - - - - - - ## 安全说明 narrow executable package without higher-risk signals. - **Geiger 风险:** 绿色 / 低 - narrow executable package without higher-risk signals ## 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 - curated package history - pkgdb category and tag curation - cross-ecosystem install command graph