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]

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.

jqp

TUI playground to experiment with jq

TLDR

SYNOPSIS

DESCRIPTION

PARAMETERS

INSTALL

CAVEATS

HISTORY

SEE ALSO