Installation
GraphQL Analyzer has three main components you can install independently:
| Component | Purpose | Most users need? |
|---|---|---|
| VS Code extension | IDE features in VS Code | Yes |
CLI (graphql) | Validation/linting in CI | Yes |
| LSP server | IDE features in other editors | Only for non-VS Code |
VS Code extension
Section titled “VS Code extension”The extension bundles the LSP server — no separate installation needed.
Install GraphQL Analyzer from the VS Code Marketplace, or search “GraphQL Analyzer” in the Extensions view (Ctrl/Cmd+Shift+X).
For VS Codium, Cursor, Windsurf, and other VS Code-compatible editors, install from the Open VSX Registry.
Other installation methods
Section titled “Other installation methods”Manual installation:
- Download the
.vsixfor your platform from the releases page - Install:
code --install-extension <file>.vsix
Platform-specific packages:
| Platform | File |
|---|---|
| macOS (Apple Silicon) | graphql-analyzer-darwin-arm64-*.vsix |
| macOS (Intel) | graphql-analyzer-darwin-x64-*.vsix |
| Linux (x86_64) | graphql-analyzer-linux-x64-*.vsix |
| Linux (ARM64) | graphql-analyzer-linux-arm64-*.vsix |
| Windows (x64) | graphql-analyzer-win32-x64-*.vsix |
Homebrew (macOS/Linux):
brew install trevor-scheer/graphql-analyzer/graphql-analyzerInstall script (macOS/Linux):
curl --proto '=https' --tlsv1.2 -LsSf https://raw.githubusercontent.com/trevor-scheer/graphql-analyzer/main/scripts/install.sh | shInstall script (Windows PowerShell):
irm https://raw.githubusercontent.com/trevor-scheer/graphql-analyzer/main/scripts/install.ps1 | iexVia Cargo:
cargo install --git https://github.com/trevor-scheer/graphql-analyzer graphql-cliBinary downloads:
| Platform | File |
|---|---|
| macOS (Apple Silicon) | graphql-cli-aarch64-apple-darwin.tar.xz |
| macOS (Intel) | graphql-cli-x86_64-apple-darwin.tar.xz |
| Linux (x86_64) | graphql-cli-x86_64-unknown-linux-gnu.tar.xz |
| Linux (ARM64) | graphql-cli-aarch64-unknown-linux-gnu.tar.xz |
| Windows (x64) | graphql-cli-x86_64-pc-windows-msvc.zip |
Download from the releases page.
LSP server (standalone)
Section titled “LSP server (standalone)”For editors other than VS Code (Neovim, Helix, etc.), install the LSP server directly.
Via Cargo:
cargo install --git https://github.com/trevor-scheer/graphql-analyzer graphql-lspBinary downloads:
| Platform | File |
|---|---|
| macOS (Apple Silicon) | graphql-lsp-aarch64-apple-darwin.tar.xz |
| macOS (Intel) | graphql-lsp-x86_64-apple-darwin.tar.xz |
| Linux (x86_64) | graphql-lsp-x86_64-unknown-linux-gnu.tar.xz |
| Linux (ARM64) | graphql-lsp-aarch64-unknown-linux-gnu.tar.xz |
| Windows (x64) | graphql-lsp-x86_64-pc-windows-msvc.zip |
Download from the releases page.
Building from source
Section titled “Building from source”git clone https://github.com/trevor-scheer/graphql-analyzercd graphql-analyzer
# Build CLIcargo build --package graphql-cli --release# Binary at target/release/graphql
# Build LSP servercargo build --package graphql-lsp --release# Binary at target/release/graphql-lsp