The workshop · Edition No. 33 · 27 Sep 2026

noahgorstein/jqp

A terminal window where a jq filter is written against a JSON file and the result updates as you type.

← The workshopRead the whole edition →
07

noahgorstein/jqp

💎 hidden gem

2,845 stars · MIT, read from /blob/main/LICENSE on 2026-09-27; copyright 2022 Noah Gorstein, no added conditions · v0.8.0 (2025-09-28), read from /releases/latest and settled by ungh · Track this in Scout

A terminal window where a jq filter is written against a JSON file and the result updates as you type.

▶Repo detailsthe review · specs · pros & cons · install

What it is

jqp is a small program that loads a JSON file and lets you write a jq filter against it with the result shown live beside it. jq is the standard command-line tool for pulling values out of JSON, and its syntax is powerful and easy to get wrong.

What it is good for. Anyone who works with an API and keeps rewriting the same filter at the shell prompt to see what it does. The normal loop is edit, run, squint, edit again. Here the feedback is immediate and the text is highlighted, so a complicated expression is assembled visually instead. It reads a file with -f or takes input piped in, and it handles both ordinary JSON and the line-by-line kind. The finished expression is then copied into a script, which is the actual point of the tool.

Stars2,845
LicenceMIT, read from /blob/main/LICENSE on 2026-09-27; copyright 2022 Noah Gorstein, no added conditions
Latestv0.8.0 (2025-09-28), read from /releases/latest and settled by ungh
Good
  • Immediate feedback with syntax highlighting turns writing a hard filter into a few seconds of iteration instead of a dozen shell commands.
  • Packaged unusually widely for a project this size — Homebrew, MacPorts, the Arch user repository, Snap, and prebuilt binaries — so most people install it with one line and never see the Go toolchain.
  • MIT, one static file, nothing to configure before the first run, and it carries its own copy of jq internally so you do not need jq installed.
Watch for
  • It has slowed down. The last release, v0.8.0, is dated 28 September 2025, which is almost twelve months ago, and no code has landed since 6 February 2026 — about seven and a half months. It works, and it is well inside the line this report draws, but it is the quietest project in this edition.
  • It helps you compose a filter; it does not replace jq in your scripts. The useful output is the expression, and you carry it out of the window by hand.
  • Appearance is configured only by hand-writing a file at $HOME/.jqp.yaml. There is no settings screen, no documentation site, and no stated memory figure — which matters, because the whole input file is held in memory while you filter it.
Similar repositories
Install
brew install jqp                                      # macOS or Linux with Homebrew
sudo snap install jqp                                 # Ubuntu and friends
go install github.com/noahgorstein/jqp@latest         # needs Go 1.24 or newer
Screenshots
noahgorstein/jqp: GitHub preview cardnoahgorstein/jqp: Screenshot 1noahgorstein/jqp: Screenshot 2

Get the next edition in your inbox

A dozen repositories, opened and checked. The licence read, the last release dated, and the ones that did not make it named with the reason. It is the half most lists leave out.

No tracking pixels. One click to leave. The archive stays free either way.

We use your address to send the edition and nothing else. Confirm by email, leave in one click. How we handle it.