# Install jq-lsp with Homebrew, Nix Jq language server. Version 0.1.17 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:jq-lsp ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install jq-lsp ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#jq-lsp ``` Evidence: nixpkgs package indexes: pkgs/by-name/jq/jq-lsp/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:jq-lsp - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.1.17 - **Source summary:** Jq language server - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - jq-lsp (cli) - jq-lsp (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.1.17 - Local data: ok - Upstream repository: https://github.com/wader/jq-lsp - Upstream latest detected: v0.1.17 (current) - info: No package-manager update timestamp was available. ## Project history and usage jq-lsp is Mattias Wadman's language server for jq, bringing editor features to jq filters and scripts. Its README lists syntax checking, missing function and binding diagnostics, goto definition, completion, import support, hover information, document symbols, and project-specific builtins through `.jq-lsp.jq`. ### Project history The project belongs to jq's later ecosystem rather than jq's original 2010s command-line history. It uses a modified version of itchyny's gojq parser and bases builtin documentation on jq manual data, making it a bridge between jq the CLI language and modern Language Server Protocol editor workflows. Public release artifacts began with the 0.1 series. The November 2025 releases added IntelliJ/LSP4IJ support, import-search behavior, jq 1.8 builtins and docs, parser fixes, and packaged binaries. January and February 2026 releases refined server internals and parser traversal. ### Adoption history jq-lsp is surfaced through editor integrations rather than as a standalone end-user data tool. The README points users toward vscode-jq, Neovim lspconfig and mason.nvim, Emacs lsp-mode, Helix, and IntelliJ with LSP4IJ, matching how language servers are usually adopted. ### How it is used Developers install `jq-lsp` with Go or a package manager and let an editor launch it for `.jq` files. The `.jq-lsp.jq` file lets a project declare additional builtin functions or variables so diagnostics and completion match the environment where jq code actually runs. ### Why package nerds care jq-lsp is package-nerd notable because it turns jq from a terse shell pipeline language into something editors can understand. It also shows a common LSP pattern: reuse an existing language parser, ship one small server binary, and let many editors share the same intelligence. ### Timeline - 2025-11-18: v0.1.2 and v0.1.14 release artifacts were published in the 0.1 line. - 2025-11-18: v0.1.14 added IntelliJ with LSP4IJ support, jq 1.8 builtins and docs, import search-path support, and related parser fixes. - 2025-11-27: v0.1.15 fixed parsing of binary operators with binding. - 2026-01-01: v0.1.16 updated gojq, moved more server CLI behavior into jq, and fixed position handling. - 2026-02-12: v0.1.17 corrected suffix-list traversal. ### Related projects - Related projects include jq, gojq, vscode-jq, Neovim lspconfig, mason.nvim, Emacs lsp-mode, Helix, and IntelliJ LSP4IJ. ### Sources - - - - - ## Security Notes broad file, network, media, or database tool signal. - **Geiger risk:** blue / medium - broad file, network, media, or database tool signal ## 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: .jq-lsp.jq ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** jq-lsp - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - jq-lsp: normalized package name match | nixpkgs package indexes: pkgs/by-name/jq/jq-lsp/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [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. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [gopls](https://www.automicvault.com/pkg/brew/gopls/) - Shares av.db curated category or tags: cli, developer-tools, editor-integration, language-server, lsp. - [python-lsp-server](https://www.automicvault.com/pkg/brew/python-lsp-server/) - Shares av.db curated category or tags: cli, developer-tools, editor-integration, language-server, lsp. - [zls](https://www.automicvault.com/pkg/brew/zls/) - Shares av.db curated category or tags: cli, developer-tools, editor-integration, language-server, lsp. - [ansible-language-server](https://www.automicvault.com/pkg/brew/ansible-language-server/) - Shares av.db curated category or tags: cli, developer-tools, language-server, lsp. - [codebook-lsp](https://www.automicvault.com/pkg/brew/codebook-lsp/) - Shares av.db curated category or tags: cli, developer-tools, editor-integration, language-server, lsp. - [dhall-lsp-server](https://www.automicvault.com/pkg/brew/dhall-lsp-server/) - Shares av.db curated category or tags: cli, developer-tools, editor-integration, language-server, lsp. - [efm-langserver](https://www.automicvault.com/pkg/brew/efm-langserver/) - Shares av.db curated category or tags: cli, developer-tools, editor-integration, language-server, lsp. - [expert](https://www.automicvault.com/pkg/brew/expert/) - Shares av.db curated category or tags: cli, developer-tools, language-server, lsp. ## Combined YAML source View the package source record on GitHub. [combined/jq-lsp.yml](https://github.com/automic-vault/db/blob/main/combined/jq-lsp.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 - external package-manager database matches - cross-ecosystem install command graph