Visit Apps Ved →

jqp

TUI playground to experiment with jq

TLDR

Open a JSON file in the playground
$ jqp -f [path/to/file.json]
Pipe JSON from stdin
$ cat [path/to/file.json] | jqp
Start with an initial query
$ jqp -f [path/to/file.json] -q '.[0]'
Use a specific theme
$ jqp -f [path/to/file.json] -t [monokai]
Use a custom config file
$ jqp -f [path/to/file.json] --config [path/to/.jqp.yaml]

SYNOPSIS

jqp [query] [flags]

DESCRIPTION

jqp is a TUI playground for exploring and experimenting with jq queries. It provides an interactive interface where you can type jq filters and see results update in real time against your JSON data. The tool internally uses gojq, a Go implementation of jq, and supports both JSON and newline-delimited JSON (NDJSON) input.Features include query history, auto-completion, customizable themes (light and dark), and the ability to start with a pre-defined query. Configuration can be provided via $HOME/.jqp.yaml or the --config flag; command-line options take precedence over the config file.

PARAMETERS

-f, --file FILE

Path to the JSON or NDJSON input file.
-q, --query QUERY
Initial jq query to execute on startup.
-t, --theme THEME
Color theme name. Light themes work best with light terminal backgrounds, dark themes with dark backgrounds.
--config FILE
Path to config file (default: $HOME/.jqp.yaml).
-h, --help
Display help information.
-v, --version
Display version information.

INSTALL

sudo apt install jqp
brew install jqp
nix profile install nixpkgs#jqp

CAVEATS

Large JSON files may impact the responsiveness of live preview updates. Input must be valid JSON or NDJSON.

HISTORY

jqp was created by Noah Gorstein and is written in Go. It was designed as a terminal-native alternative to web-based jq playgrounds.

SEE ALSO

jq(1), jnv(1), fx(1)