Home

Awesome

jq fish plugin

Interactively build jq expressions (gojq is also supported).

This fish plugin gives you jq superpowers! (See also: upstream zsh plugin.)

This fish fork is not as well tested yet!

Table of contents

Demos

Interactive jq query construction

asciicast

Insert jq query in the middle of a pipeline

asciicast

Installation

Besides jq, this plugin also requires fzf (a recent version) to be installed and available on your PATH.

For automatic yaml support, install gojq as well.

Fisher

fisher install rmartine-ias/jq-fish-plugin

Usage

Key bindings

Bringing up the jq query builder for a shell command: alt + j

During interactive querying, the following shortcuts can be used:

ShortcutEffect
upNavigate path queries
downNavigate path queries
tabSelect path query
shift + upScroll up
shift + downScroll down
alt + upScroll up full page
alt + downScroll down full page
ctrl+rReload input

gojq support

If you want to use an alternative jq implementation, like gojq then you can override the default jq command used by the plugin. Set the following environment variable:

JQ_REPL_JQ=gojq

Internals

The project consists of the following components:

Troubleshooting

MacOS: Pressing alt-j creates a symbol in iTerm2

You need to remap your alt-key to Esc+ in iTerm2:

See other suggestions on stackoverflow if the above one doesn't help you: https://stackoverflow.com/q/196357/205318

Another option is to map to ctrl+j instead by putting this in your .zshrc:

bindkey `^j` jq-complete