# Install ijq with Homebrew, apk, MacPorts, Nix, pacman

Interactive jq. Version 1.3.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:ijq
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install ijq
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install ijq
```

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

### Linux

- apk (92%):

```sh
sudo apk add ijq
```

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

- Nix (92%):

```sh
nix profile install nixpkgs#ijq
```

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

- pacman (92%):

```sh
sudo pacman -S ijq
```

  Evidence: Arch Linux sync databases: ijq from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## Package facts

- **Package key:** brew:ijq
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/ijq>
- **Version:** 1.3.0
- **Source summary:** Interactive jq
- **Homepage:** <https://codeberg.org/gpanders/ijq>
- **Repository:** <https://codeberg.org/gpanders/ijq>
- **Upstream docs:** <https://codeberg.org/gpanders/ijq>
- **License:** GPL-3.0-or-later
- **Source archive:** <https://codeberg.org/gpanders/ijq/archive/v1.3.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- ijq (cli)
- ijq (alias)

## Build dependencies

- go
- scdoc

## Uses from macOS

- jq

## 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.3.0
- Local data: ok
- Upstream repository: https://codeberg.org/gpanders/ijq
- info: No package-manager update timestamp was available.
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

ijq is a terminal interface around jq, built for interactive exploration of JSON filters before reusing them in scripts. Its README describes it as an interactive jq tool, like jqplay for the command line, and notes that jq remains the underlying filter engine.

### Project history

The public tag history reaches v0.1.0 in 2020, and the project later moved its primary home to Codeberg while preserving a GitHub mirror for contributions. Release notes for v1.2.0 mention removing remaining SourceHut references, and v1.3.0 tells packagers that ijq lives at Codeberg.

The tool stayed intentionally close to jq rather than becoming a separate query language. Its later evolution added terminal usability features: asynchronous jq subprocess handling for large inputs, an overlay menu, configurable key bindings, filter history, and a config file.

### Adoption history

ijq occupies the package-manager niche for people who already use jq but want fast feedback while building a filter. Homebrew, MacPorts, Nix, Arch, and Alpine package metadata in the input show distribution across Unix-like package ecosystems; Homebrew formula metadata records binary bottles and install analytics.

### How it is used

A common workflow is to open a JSON file or pipe API output into ijq, edit the jq filter interactively, then press Return to emit the filtered output and save the filter for later jq use. The README also documents history storage under the XDG data path and a config file for changing the history file, jq binary, pane visibility, and key bindings.

### Why package nerds care

For package nerds, ijq is interesting because it packages an ergonomic shell companion rather than a new data-processing stack. It is small, jq-compatible, and useful in the same workflows where people already install jq, fx, jless, or browser-based jqplay.

### Timeline

- 2020: v0.1.0 appears in the public tag history.
- 2024: v1.1.0 improves UI responsiveness by running jq subprocess work without blocking the main interface.
- 2025: v1.2.0 removes remaining SourceHut references and documents the Codeberg home for packagers.
- 2026: v1.3.0 adds a config file, overlay menu, history management, and Codeberg CI.

### Related projects

- ijq is directly related to jq and jqplay. The README also points to vim-jqplay as similar work, while package users may compare it with adjacent JSON explorers such as fx or jless.

### Sources

- Project README, Codeberg release notes, Codeberg repository metadata, and Homebrew formula metadata.


## Security Notes

narrow executable package without higher-risk signals.

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


## 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: $XDG_CONFIG_HOME/ijq/config, ~/.config/ijq/config
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** ijq
- **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 - ijq: normalized package name match | nixpkgs package indexes: pkgs/by-name/ij/ijq/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - ijq - 1.2.0-r7: normalized package name match | Alpine Linux edge package indexes: ijq from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Interactive jq tool | https://codeberg.org/gpanders/ijq
- apk - ijq-doc - 1.2.0-r7: normalized package name match | Alpine Linux edge package indexes: ijq-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Interactive jq tool (documentation) | https://codeberg.org/gpanders/ijq
- pacman - ijq - 1.3.0-1: normalized package name match | Arch Linux sync databases: ijq from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Interactive jq tool, like jqplay for the commandline | https://git.sr.ht/~gpanders/ijq
- MacPorts - ijq: normalized package name match | MacPorts ports tree: textproc/ijq/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [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.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [scdoc](https://www.automicvault.com/pkg/brew/scdoc/) - Build dependency declared by Homebrew.
- [csview](https://www.automicvault.com/pkg/brew/csview/) - Shares av.db curated category or tags: cli, data-tools, developer-tools, terminal.
- [jnv](https://www.automicvault.com/pkg/brew/jnv/) - Shares av.db curated category or tags: cli, developer-tools, interactive, jq, json.
- [jq](https://www.automicvault.com/pkg/brew/jq/) - Shares av.db curated category or tags: cli, data-tools, developer-tools, json.
- [jql](https://www.automicvault.com/pkg/brew/jql/) - Shares av.db curated category or tags: cli, data-tools, developer-tools, json.
- [sbjson](https://www.automicvault.com/pkg/brew/sbjson/) - Shares av.db curated category or tags: cli, data-tools, developer-tools, json.
- [yh](https://www.automicvault.com/pkg/brew/yh/) - Shares av.db curated category or tags: cli, data-tools, developer-tools, terminal.
- [yj](https://www.automicvault.com/pkg/brew/yj/) - Shares av.db curated category or tags: cli, data-tools, developer-tools, json.
- [csvprintf](https://www.automicvault.com/pkg/brew/csvprintf/) - Shares av.db curated category or tags: cli, data-tools, developer-tools.

## Combined YAML source

View the package source record on GitHub. [combined/ijq.yml](https://github.com/automic-vault/db/blob/main/combined/ijq.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
