Interactive jq
abb780c8 — Greg Anders 26 days ago
Remove superfluous example in README
d2a15827 — Greg Anders 26 days ago
Use canonical Makefile variable names
a239034e — Greg Anders 27 days ago
Fix asset name in README example



You can also use your local clone with git send-email.


Interactive jq tool. Like jqplay for the commandline.




If you use macOS and Homebrew, you can install ijq with

brew install gpanders/tap/ijq

Download a release

Select the version you want to download from sourcehut and download one of the precompiled releases from that page. Then extract the archive somewhere on your system path.


wget https://git.sr.ht/~gpanders/ijq/refs/v0.1.0/ijq-linux-x86_64.tar.gz
tar -C /usr/local/bin/ -xf ijq-linux-x86_64.tar.gz

Build from source

Install go. To install ijq under /usr/local/bin/ simply run

make install

from the root of the project. To install to another location, set the prefix variable, e.g.

make prefix=~/.local install


ijq uses jq under the hood, so make sure you have that installed first.

Read from a file:

ijq file.json

Read from stdin:

curl -s https://api.github.com/users/gpanders | ijq

Press Return to close ijq and print the current filtered output to stdout. This will also print the current filter to stderr. This allows you to save the filter for re-use with jq in the future:

ijq file.json 2>filter.jq

# Same output as above
jq -f filter.jq file.json

Press Tab or Shift-Tab to cycle through the windows. The display windows can be scrolled using Vim-like bindings, i.e. hjkl or the arrow keys.

Similar Work