# Install graphql-cli with Homebrew

Command-line tool for common GraphQL development workflows. Version 4.1.0 via Homebrew; verified from local package data.

## Install

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

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install graphql-cli
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:graphql-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/graphql-cli>
- **Version:** 4.1.0
- **Source summary:** Command-line tool for common GraphQL development workflows
- **Homepage:** <https://github.com/Urigo/graphql-cli>
- **Repository:** <https://github.com/Urigo/graphql-cli>
- **Upstream docs:** <https://github.com/Urigo/graphql-cli#readme>
- **License:** MIT
- **Source archive:** <https://registry.npmjs.org/graphql-cli/-/graphql-cli-4.1.0.tgz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- graphql (cli)
- graphql (alias)

## Dependencies

- node

## Install behavior

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

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 4.1.0
- Local data: ok
- Upstream repository: https://github.com/Urigo/graphql-cli
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

GraphQL CLI is a Node-based command-line tool for common GraphQL development workflows. It wraps project initialization, GraphQL Config, plugin commands, schema handling, code generation, and related GraphQL ecosystem tools behind the `graphql` command.

### Project history

The package originated in the Prisma/Graphcool-era GraphQL tooling ecosystem and later moved into The Guild's maintenance orbit along with graphql-config, graphql-import, and graphql-binding. Prisma's handoff announcement explicitly named graphql-cli among the libraries transferred to The Guild.

The Guild then rebooted GraphQL CLI as an extensible, plugin-oriented tool. The project documentation for version 4 describes a restructured setup based around `.graphqlrc.yml`, a unified GraphQL Config file, and per-command packages.

### Adoption history

GraphQL CLI's adoption was tied to the JavaScript GraphQL ecosystem's need for a single command that could initialize projects, read schemas and documents, run code generation, and host schema-inspection workflows.

Version 4.0 changed the configuration model from older `.graphqlconfig` and endpoint/schemaPath assumptions toward `.graphqlrc.yml` and the newer GraphQL Config shape. Version 4.1 added starter-template improvements and stronger integration with GraphQL Code Generator and GraphQL Inspector.

### How it is used

The main command is `graphql`. Users initialize a project with `graphql init` or `npx graphql-cli init`, then keep schema and document paths in `.graphqlrc.yml`.

The plugin model lets commands such as code generation live in separate packages and read the same GraphQL Config. The migration guide is important for older users because it documents removed commands and changed configuration names.

### Why package nerds care

GraphQL CLI is a snapshot of a specific GraphQL tooling moment: Prisma-era tools, The Guild maintenance, GraphQL Config standardization, and an attempt to make a single extensible CLI sit above many competing GraphQL stacks.

For package maintainers, it is notable as a Homebrew formula for a Node CLI whose upstream ecosystem also expects npm or yarn global installation. That split often exposes how JavaScript CLIs move between language package managers and system package managers.

### Timeline

- 2019: Prisma announced transfer of graphql-cli and related libraries to The Guild.
- 2019: The Guild described a rewritten, extensible GraphQL CLI.
- 2020: GraphQL CLI 4.0 was released with a restructured project setup.
- 2020: GraphQL CLI 4.1 added template and ecosystem-tooling integration improvements.

### Related projects

- GraphQL Config supplies the configuration model used by GraphQL CLI.
- GraphQL Code Generator and GraphQL Inspector are explicitly integrated into the GraphQL CLI 4.1 workflow.
- Prisma, GraphQL Import, and GraphQL Binding are part of the same historical handoff described by Prisma and The Guild.

### Sources

- <https://github.com/Urigo/graphql-cli>
- <https://github.com/Urigo/graphql-cli/blob/master/README.md>
- <https://github.com/Urigo/graphql-cli/blob/master/docs/MIGRATION.md>
- <https://github.com/Urigo/graphql-cli/releases>
- <https://the-guild.dev/graphql/hive/blog/graphql-cli-is-back>
- <https://the-guild.dev/graphql/hive/blog/whats-new-in-graphql-cli-4.1.0>
- <https://www.prisma.io/blog/the-guild-takes-over-oss-libraries-vvluy2i4uevs>


## Security Notes

narrow executable package without higher-risk signals.

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


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: .graphqlrc.yml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** graphql-cli
- **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

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [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.
- [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew.
- [graphql-inspector](https://www.automicvault.com/pkg/brew/graphql-inspector/) - Shares av.db curated category or tags: cli, developer-tools, graphql.
- [graphqlviz](https://www.automicvault.com/pkg/brew/graphqlviz/) - Shares av.db curated category or tags: cli, developer-tools, graphql.
- [graphqurl](https://www.automicvault.com/pkg/brew/graphqurl/) - Shares av.db curated category or tags: cli, developer-tools, graphql.
- [graphqxl](https://www.automicvault.com/pkg/brew/graphqxl/) - Shares av.db curated category or tags: cli, developer-tools, graphql, schema.
- [rover](https://www.automicvault.com/pkg/brew/rover/) - Shares av.db curated category or tags: cli, developer-tools, graphql.
- [grpcui](https://www.automicvault.com/pkg/brew/grpcui/) - Shares av.db curated category or tags: api-tools, cli, developer-tools.
- [grpcurl](https://www.automicvault.com/pkg/brew/grpcurl/) - Shares av.db curated category or tags: api-tools, cli, developer-tools.
- [oauth2c](https://www.automicvault.com/pkg/brew/oauth2c/) - Shares av.db curated category or tags: api-tools, cli, developer-tools.
- [graphql-cli](https://www.automicvault.com/pkg/npm/graphql-cli/) - Same normalized package name appears in another local ecosystem. Shared terms: cli, common, development, graphql, graphql-cli.
- [graphql-cli](https://www.automicvault.com/pkg/npm/graphql-cli/) - Same normalized package name in another local ecosystem.

## Combined YAML source

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


## Sources

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