# Install jql with Homebrew, apk, dnf, MacPorts, Nix

JSON query language CLI tool. Version 8.1.2 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:jql
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install jql
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install jql
```

  Evidence: MacPorts ports tree: textproc/jql/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add jql
```

  Evidence: Alpine Linux edge package indexes: jql from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- dnf (92%):

```sh
sudo dnf install jql
```

  Evidence: Fedora Rawhide package metadata: jql 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#jql
```

  Evidence: nixpkgs package indexes: pkgs/by-name/jq/jql/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:jql
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/jql>
- **Version:** 8.1.2
- **Source summary:** JSON query language CLI tool
- **Homepage:** <https://github.com/yamafaktory/jql>
- **Repository:** <https://github.com/yamafaktory/jql>
- **Upstream docs:** <https://github.com/yamafaktory/jql#readme>
- **License:** Apache-2.0 OR MIT
- **Source archive:** <https://github.com/yamafaktory/jql/archive/refs/tags/jql-v8.1.2.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- jql (cli)
- jql (alias)

## Build dependencies

- rust

## 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: 8.1.2
- Local data: ok
- Upstream repository: https://github.com/yamafaktory/jql
- Upstream latest detected: jql-v8.1.2 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

jql is a Rust command-line JSON query language and runner. It positions itself as a fast, lightweight, deliberately simple JSON selection tool rather than a jq-compatible language.

### Project history

The Rust crate metadata dates the jql package to 2018-10-06. The repository later settled into a workspace with the jql binary plus jql-parser and jql-runner library crates, exposing the parser and execution pieces as reusable Rust packages.

### Adoption history

jql has broader packaging than most niche JSON CLIs in this batch. Its README lists installation routes through Alpine, Arch AUR, Cargo, Cargo Binstall, Fedora, FreeBSD, Homebrew, Nix, openSUSE, and GitHub release binaries. Crates.io reported 248,530 total downloads and 3,640 recent downloads for the jql crate on 2026-07-01.

### How it is used

jql accepts a query token sequence and returns JSON, with object selectors, array selectors, ranges, flattening, key extraction, streaming line-by-line input, validation, inline output, raw string output, and file-based queries. The README explicitly says there is no plan to align jql with jq or similar tools.

### Why package nerds care

For package collectors, jql is interesting as one of several post-jq experiments that treat JSON querying as a compact shell primitive but choose a new grammar. Its split crates also make it more library-shaped than a single binary-only utility.

### Timeline

- 2018: Crates.io recorded the jql crate creation on 2018-10-06.
- 2026: The GitHub release feed recorded jql, jql-parser, and jql-runner 8.1.x releases on 2026-03-18.
- 2026: Homebrew formula API packaged jql 8.1.2 from the jql-v8.1.2 GitHub archive.

### Related projects

- jql is related to jq by domain rather than compatibility. Within its own repository, the most direct related projects are the jql-parser and jql-runner crates.

### Sources

- <https://crates.io/crates/jql>
- <https://docs.rs/jql-parser/latest/jql_parser/>
- <https://docs.rs/jql-runner/latest/jql_runner/>
- <https://formulae.brew.sh/api/formula/jql.json>
- <https://github.com/yamafaktory/jql>


## Security Notes

narrow executable package without higher-risk signals.

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

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** jql
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - jql: normalized package name match | nixpkgs package indexes: pkgs/by-name/jq/jql/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - jql - 8.0.5-r0: normalized package name match | Alpine Linux edge package indexes: jql from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | A JSON Query Language CLI tool | https://github.com/yamafaktory/jql
- dnf - jql - 8.1.2-1.fc45: normalized package name match | Fedora Rawhide package metadata: jql from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | JQL is a fast and simple command-line tool to manipulate JSON data | https://crates.io/crates/jql
- MacPorts - jql: normalized package name match | MacPorts ports tree: textproc/jql/Portfile from https://api.github.com/repos/macports/macports-ports/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.
- [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.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [jq](https://www.automicvault.com/pkg/brew/jq/) - 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.
- [jaq](https://www.automicvault.com/pkg/brew/jaq/) - Shares av.db curated category or tags: cli, developer-tools, json, query-language, rust.
- [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.
- [csvprintf](https://www.automicvault.com/pkg/brew/csvprintf/) - Shares av.db curated category or tags: cli, data-tools, developer-tools.
- [fblog](https://www.automicvault.com/pkg/brew/fblog/) - Shares av.db curated category or tags: cli, developer-tools, json, rust.
- [gojq](https://www.automicvault.com/pkg/brew/gojq/) - Both packages work with overlapping file formats or content types. Shared terms: cli, developer, developer-tools, json, language.

## Combined YAML source

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


## Sources

- Nucleus package database
- Geiger risk classifier
- 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
