You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Mattias Wadman cff5336ec7 docs: Document repeat(exp) 3 months ago
.github/ISSUE_TEMPLATE docs: point to Libera.Chat instead of Freenode 3 months ago
build Rake task to build website including source dist and binaries. 9 years ago
config Bugfix: Math function checking 4 years ago
docs docs: Document repeat(exp) 3 months ago
m4 Use AX_PTHREAD to properly detect pthread and flags 2 years ago
modules Update oniguruma to fix #1370 5 years ago
scripts Remove ruby dependency from website build 4 years ago
sig Release jq-1.6 4 years ago
src Fix iterration problem for non decimal string 3 months ago
tests Fix iterration problem for non decimal string 3 months ago
.gitattributes Remove .gitignore from tarballs. 10 years ago
.gitignore Save literal value of the parsed number to preserve it for the output 3 years ago
.gitmodules Add local oniguruma submodule 6 years ago
.travis.yml Ensure travis has a python version we expect 3 years ago
AUTHORS Update AUTHORS 4 months ago
COPYING Fix Windows build for 1.7 release (pthread stuff) 11 months ago
ChangeLog Update ChangeLog 7 years ago
Dockerfile Dockerfile: Uninstall oniguruma before distclean 3 years ago
KEYS Remove David from maintainers 7 years ago Makefile: prepend srcdir to jq.1.prebuilt to fix out of source compilation 2 years ago
NEWS Adds the release info for 1.6 to NEWS 4 years ago
README Check in a pile of Autotools junk, including the configure script. 9 years ago docs: point to Libera.Chat instead of Freenode 3 months ago
appveyor.yml Appveyor: Get Appveyor building again 10 months ago realpath is not a default command. 3 years ago Add large file support for 32-bit systems to fix issue 2167 1 year ago
jq.1.prebuilt Fixed typos 3 months ago
jq.spec Use https where possible 7 years ago Add pkg-config file for libjq 3 years ago


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

Coverage Status, Unix: Build Status, Windows: Windows build 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:, where you will find cookbooks, discussion of advanced topics, internals, release engineering, and more.

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, automake, and autoconf installed. To get regexp support you'll also need to install Oniguruma or clone it as a git submodule as per the instructions below. (note that jq's tests require regexp support to pass). To build, run:

git submodule update --init # if building from git to get oniguruma
autoreconf -fi              # if building from git
./configure --with-oniguruma=builtin
make -j8
make check

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

./configure --with-oniguruma=builtin --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 "Cross compilation" on the wiki.

Send questions to or to the #jq channel ( on Libera.Chat (