# Install jq-lsp with Homebrew, Nix

Jq language server. Version 0.1.18 via Homebrew; verified 2026-07-26. Also installable with nix: nix profile install nixpkgs#jq-lsp.

## 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
- **Version:** 0.1.18
- **Source summary:** Jq language server
- **Homepage:** <https://github.com/wader/jq-lsp>
- **Repository:** <https://github.com/wader/jq-lsp>
- **Last updated:** 2026-07-26T04:08:07+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- jq-lsp (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.1.18
## 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

- <https://github.com/jqlang/awesome-jq>
- <https://github.com/wader/jq-lsp>
- <https://github.com/wader/jq-lsp/releases>
- <https://github.com/wader/vscode-jq>
- <https://raw.githubusercontent.com/wader/jq-lsp/master/README.md>


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


## Combined YAML source

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


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph