jiq

An interactive terminal tool for jq. Type a query, see results live, navigate into nested values with a single keystroke.

Get started Quick reference GitHub

jiq data.json

Query: .users[] | select(.active) | .email

 

Results:

"alice@example.com"

"carol@example.com"

"dave@example.com"

 

3 results in 4ms

---

What do you want to do?

Explore deeply nested JSON

Navigate with j/k, press > to zoom in, < to step back

Fix a broken jq query

Press Ctrl+A for AI suggestions that see your data and error

Find a specific value in the output

Press Ctrl+F, type a term, hit n/N to jump between matches

Reuse a query I wrote before

Save it once with Ctrl+S, recall instantly by name any time

I don't know the field names

Type . and see every field with its type, pulled from your data

Edit complex queries efficiently

Full Vim motions: ciw, dt|, da" to reshape in seconds

Copy specific output lines

Press v to select lines, y to copy to clipboard

Work with clipboard JSON

Just run jiq with no arguments — it reads your clipboard directly

---

Quick start

Requires jq on $PATH.

macOS

brew install bellicose100xp/tap/jiq

macOS / Linux

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/bellicose100xp/jiq/releases/latest/download/jiq-installer.sh | sh

Any platform with Rust

cargo install jiq

Windows / others: pre-built binaries

Then:

jiq data.json        # file
curl -s api | jiq    # stdin
jiq                  # reads clipboard; opens a paste editor if needed

---

All features

Live query execution

Results update with every keystroke. No edit-run-check loop — you see exactly what your query produces as you type it, so you can iterate in seconds instead of minutes.

Context-aware autocomplete

Suggests field names drawn from your actual data, with types shown alongside. No need to memorize your JSON structure — jiq shows you what's available at every level.

AI-powered query help

When a query fails or you're unsure of the syntax, the AI sees your data and the error, then offers working alternatives you can apply instantly.

Saved query library

Store queries you use often and recall them by name. Stop rewriting the same complex filters from memory every time you need them.

Search within output

Find specific values in large results instantly. Matches highlight in real time and you can step through them one by one — no manual scrolling required.

Persistent query history

Every successful query is remembered across sessions. Recall any previous query by searching through your history — even ones from days ago.

Efficient query editing

Reshape complex queries in a few keystrokes using Vim-style motions and text objects. Or just type normally — advanced editing is there when you need it, invisible when you don't.

Clipboard integration

Copied JSON from a browser or API response? Just launch jiq — it reads your clipboard directly. No need to save to a file first.

Full mouse support

Point and click wherever you prefer it over the keyboard. Select output lines by dragging, scroll through results, click suggestions to apply them.

Inline documentation

Forgot how a jq function works? A tooltip shows its signature and usage examples right in the editor — no context switch to a browser needed.