Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Command-line JSON processor
C Yacc JSONiq Shell C++ Lex Python
Failed to load latest commit information.
build Rake task to build website including source dist and binaries.
config Add `pow`, better libm detection (fix #443)
docs yum has been replaced with dnf as of f22
m4 BSD sed lacks -r; fix #551
scripts Copy gitignore in website update script
sig Fix linux32 jq-1.5 executable (fix #935)
src Support numbers and boolean in join (fix #930)
tests Support numbers and boolean in join (fix #930)
.gitattributes Remove .gitignore from tarballs.
.gitignore Move jq-coded builtins to non-C file (fix #424)
.travis.yml No-op commit to trigger first run of Travis.
AUTHORS Remove duplicate author
COPYING Use https where possible
ChangeLog Update ChangeLog
Dockerfile Oniguruma hash in dockerfile
KEYS Add signing key and dtolnay's key fingerprints to KEYS Add address sanitizer (ASAN) support (fix #1002)
NEWS Update website for jq 1.5 (fix #910)
README Check in a pile of Autotools junk, including the configure script. Add travis and coveralls badges to readme Get oniguruma from github instead of geocities Support --without-oniguruma
jq.1.prebuilt Rebuild jq.1.prebuilt
jq.spec Use https where possible


jq is a lightweight and flexible command-line JSON processor.

Build Status Coverage Status

If you want to learn to use jq, read the documentation at This documentation is generated from the docs/ folder of this repository. You can also try it online at

If you want to hack on jq, feel free, but be warned that its internals are not well-documented at the moment. Bring a hard hat and a shovel. Also, read the wiki:

Source tarball and built executable releases can be found on the homepage and on the github release page,

If you're building directly from the latest git, you'll need flex, bison (3.0 or newer), libtool, make, and autoconf installed. To get regexp support you'll also need to install Oniguruma (note that jq's tests require regexp support to pass). To build, run:

autoreconf -i   # if building from git
make -j8
make check

To build without bison or flex, add --disable-maintainer-mode to the ./configure invocation:

./configure --disable-maintainer-mode

(Developers must not use --disable-maintainer-mode, not when making changes to the jq parser and/or lexer.)

To build a statically linked version of jq, run:

make LDFLAGS=-all-static

After make finishes, you'll be able to use ./jq. You can also install it using:

sudo make install

If you're not using the latest git version but instead building a released tarball (available on the website), then you won't need to run autoreconf (and shouldn't), and you won't need flex or bison.

To cross-compile for OS X and Windows, see docs/Rakefile's build task and scripts/crosscompile. You'll need a cross-compilation environment, such as Mingw for cross-compiling for Windows.

Cross-compilation requires a clean workspace, then:

# git clean ...
autoreconf -i
make distclean
scripts/crosscompile <name-of-build> <configure-options>

Use the --host= and --target= ./configure options to select a cross-compilation environment. See also the wiki.

Send questions to or to the #jq channel ( on Freenode (

Something went wrong with that request. Please try again.