# Install jq with Homebrew, apk, chocolatey, apt, dnf, MacPorts, Nix, pacman, scoop, winget, zypper Lightweight and flexible command-line JSON processor. Version 1.8.2 via Homebrew; verified 2026-06-20. ## Install ```sh sudo av install brew:jq ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install jq ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install jq ``` Evidence: MacPorts ports tree: sysutils/jq/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add jq ``` Evidence: Alpine Linux edge package indexes: jq from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install jq ``` Evidence: Debian stable package indexes: jq from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - dnf (92%): ```sh sudo dnf install jq ``` Evidence: Fedora Rawhide package metadata: jq from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#jq ``` Evidence: nixpkgs package indexes: pkgs/by-name/jq/jq/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S jq ``` Evidence: Arch Linux sync databases: jq from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install jq ``` Evidence: openSUSE Tumbleweed package metadata: jq from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ### Windows - Chocolatey (92%): ```sh choco install jq ``` Evidence: Chocolatey community package catalog: jq from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','jetbrains-rider' - Scoop (92%): ```sh scoop install main/jq ``` Evidence: Scoop official bucket manifest trees: bucket/jq.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 - winget (92%): ```sh winget install --id jqlang.jq -e ``` Evidence: Windows Package Manager source index: jqlang.jq from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:jq - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.8.2 - **Source summary:** Lightweight and flexible command-line JSON processor - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-20T16:30:04Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - jq (cli) - jq (alias) ## Dependencies - oniguruma ## 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: 1.8.2 - Package-manager updated: 2026-06-20 - Local data: ok - Upstream repository: https://github.com/jqlang/jq - info: No cached GitHub release or tag data was available. ## Project history and usage jq is the canonical command-line JSON processor: a small C program and language for slicing, filtering, mapping, and transforming structured JSON data. The official site describes it as doing for JSON what `sed`, `awk`, `grep`, and related tools do for text. ### Project history jq was created by Stephen Dolan and grew into a standalone query language with filters, pipes, generators, functions, modules, streaming input, and a C library. Its zero-runtime-dependency binary made it easy to distribute in scripts, containers, CI jobs, and production debugging environments. The public release line was already established by jq 1.3 in May 2013 and jq 1.4 in June 2014. jq 1.5 in August 2015 added substantial language features including datetime, math, regular-expression functions, try/catch syntax, destructuring, a streaming parser, and a module system. jq 1.6 followed in November 2018. After a five-year gap, jq governance moved into the jqlang GitHub organization. The 1.7 release in September 2023 credited the new organization, new maintainers and admins, Stephen Dolan's repository transfer, updated CI and release infrastructure, broader platform binaries, Docker images from GitHub Container Registry, and OSS-Fuzz integration. ### Adoption history jq became a default tool for API users, shell programmers, SREs, CI maintainers, and package authors because JSON became the lingua franca of web APIs and cloud CLIs. It is packaged across Homebrew, Linux distributions, MacPorts, Nix, Chocolatey, Scoop, winget, and other ecosystems, and its filters are routinely embedded in documentation and automation snippets. ### How it is used Common usage ranges from pretty-printing and extracting fields to reshaping API responses, validating shell pipeline output, transforming config data, and writing reusable jq modules. Its single-binary distribution model also makes it popular in containers and remote machines where installing a language runtime would be heavier. ### Why package nerds care jq is one of the defining package-manager CLIs of the JSON era. Package nerds care about it because it is both a tiny executable and a language ecosystem: build systems depend on it, tests shell out to it, release pipelines parse with it, and downstream tools such as gojq, jaq, fq, jq-lsp, playgrounds, and editor integrations orbit its syntax and behavior. ### Timeline - 2013-05-19: jq 1.3 was released. - 2014-06-09: jq 1.4 was released. - 2015-08-15: jq 1.5 was released with major language and parser features. - 2018-11-01: jq 1.6 was released. - 2023-09-07: jq 1.7 was released after a five-year hiatus under the jqlang organization. - 2023-12-13: jq 1.7.1 was released with security and bug fixes. - 2025-06-01: jq 1.8.0 was released. - 2026-06-20: jq 1.8.2 was released with security fixes, bug fixes, and additional builds. ### Related projects - Related projects include gojq, jaq, fq, jq-lsp, vscode-jq, jqlang/awesome-jq, play.jqlang.org, and package-manager formulas that distribute jq as a ubiquitous scripting dependency. ### Sources - - - - - ## Security Notes doc example: narrow deterministic data processor. - **Geiger risk:** green / high - doc example: narrow deterministic data processor - **Approval gate rules:** 3 ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** jq - **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 - Debian apt - jq - 1.7.1-6+deb13u2: normalized package name match | Debian stable package indexes: jq from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | lightweight and flexible command-line JSON processor | https://jqlang.github.io/jq - Debian apt - libjq-dev - 1.7.1-6+deb13u2: normalized package name match | Debian stable package indexes: libjq-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | lightweight and flexible command-line JSON processor - development files | https://jqlang.github.io/jq - Debian apt - libjq1 - 1.7.1-6+deb13u2: normalized package name match | Debian stable package indexes: libjq1 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | lightweight and flexible command-line JSON processor - shared library | https://jqlang.github.io/jq - Nix - jq: normalized package name match | nixpkgs package indexes: pkgs/by-name/jq/jq/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - jq - 1.7.1-3build1: normalized package name match | Ubuntu 24.04 LTS package indexes: jq from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | lightweight and flexible command-line JSON processor | https://jqlang.github.io/jq - Ubuntu apt - libjq-dev - 1.7.1-3build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libjq-dev from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | lightweight and flexible command-line JSON processor - development files | https://jqlang.github.io/jq - Ubuntu apt - libjq1 - 1.7.1-3build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libjq1 from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | lightweight and flexible command-line JSON processor - shared library | https://jqlang.github.io/jq - apk - jq - 1.8.1-r0: normalized package name match | Alpine Linux edge package indexes: jq from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | A lightweight and flexible command-line JSON processor | https://jqlang.github.io/jq/ - apk - jq-dev - 1.8.1-r0: normalized package name match | Alpine Linux edge package indexes: jq-dev from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | A lightweight and flexible command-line JSON processor (development files) | https://jqlang.github.io/jq/ - apk - jq-doc - 1.8.1-r0: normalized package name match | Alpine Linux edge package indexes: jq-doc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | A lightweight and flexible command-line JSON processor (documentation) | https://jqlang.github.io/jq/ - dnf - jq - 1.8.1-3.fc45: normalized package name match | Fedora Rawhide package metadata: jq from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Command-line JSON processor | https://jqlang.org/ - dnf - jq-devel - 1.8.1-3.fc45: normalized package name match | Fedora Rawhide package metadata: jq-devel from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Development files for jq | https://jqlang.org/ - pacman - jq - 1.8.1-3: normalized package name match | Arch Linux sync databases: jq from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Command-line JSON processor | https://jqlang.github.io/jq/ - zypper - jq - 1.8.1-3.1: normalized package name match | openSUSE Tumbleweed package metadata: jq from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | A lightweight and flexible command-line JSON processor | https://github.com/jqlang - zypper - libjq-devel - 1.8.1-3.1: normalized package name match | openSUSE Tumbleweed package metadata: libjq-devel from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Development files for jq | https://github.com/jqlang - zypper - libjq1 - 1.8.1-3.1: normalized package name match | openSUSE Tumbleweed package metadata: libjq1 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Library for a lightweight and flexible command-line JSON processor | https://github.com/jqlang ## 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. - [oniguruma](https://www.automicvault.com/pkg/brew/oniguruma/) - Runtime dependency declared by Homebrew. - [gascity](https://www.automicvault.com/pkg/brew/gascity/) - Popular package that depends on this formula. - [todoman](https://www.automicvault.com/pkg/brew/todoman/) - Popular package that depends on this formula. - [zsv](https://www.automicvault.com/pkg/brew/zsv/) - Popular package that depends on this formula. - [jql](https://www.automicvault.com/pkg/brew/jql/) - Shares av.db curated category or tags: cli, data-tools, developer-tools, json, query-language. - [ijq](https://www.automicvault.com/pkg/brew/ijq/) - Shares av.db curated category or tags: cli, data-tools, developer-tools, json. - [jello](https://www.automicvault.com/pkg/brew/jello/) - Shares av.db curated category or tags: cli, developer-tools, json, json-processing. - [jqfmt](https://www.automicvault.com/pkg/brew/jqfmt/) - Shares av.db curated category or tags: cli, developer-tools, json, json-processing. - [jqp](https://www.automicvault.com/pkg/brew/jqp/) - Shares av.db curated category or tags: cli, developer-tools, json, json-processing. - [sbjson](https://www.automicvault.com/pkg/brew/sbjson/) - Shares av.db curated category or tags: cli, data-tools, developer-tools, json. - [yj](https://www.automicvault.com/pkg/brew/yj/) - Shares av.db curated category or tags: cli, data-tools, developer-tools, json. - [csview](https://www.automicvault.com/pkg/brew/csview/) - Shares av.db curated category or tags: cli, data-tools, developer-tools. - [jaq](https://www.automicvault.com/pkg/brew/jaq/) - Both packages work with overlapping file formats or content types. Shared terms: cli, data, developer, developer-tools, jq. - [python-yq](https://www.automicvault.com/pkg/brew/python-yq/) - Both packages work with overlapping file formats or content types. Shared terms: cli, command-line, data, developer, developer-tools. - [jq](https://www.automicvault.com/pkg/npm/jq/) - Same normalized package name in another local ecosystem. ## Combined YAML source View the package source record on GitHub. [combined/jq.yml](https://github.com/automic-vault/db/blob/main/combined/jq.yml) ## Sources - Nucleus package database - Geiger risk classifier - approval-gate seed metadata - package-page enrichment - 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