Interactive jq

87cd611 Show usage when no arguments given

~gpanders pushed to ~gpanders/ijq git

17 days ago

3ecc273 Update man page to reflect updated pane positions

~gpanders pushed to ~gpanders/ijq git

17 days ago


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.1/ijq-v0.1.1-linux-x86_64.tar.gz
tar -C /usr/local/bin/ -xf ijq-v0.1.1-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

To generate the man page you will also need to have scdoc installed.


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