Skip to content
Projects

davesnx/query-json has 640 GitHub stars and 11 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 04:16 UTC. Last push 2026-11-12.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Faster, simpler and more portable implementation of jq-inspired language in OCaml

Developer Tools

README.md

Original



query-json logo query-json logo

A fast, friendly and portable JSON query language for the command line.

query-json lets you slice, filter, and transform JSON data with a concise, expressive syntax. It started as a jq-compatible implementation, but evolved into something better: faster execution, better error messages, and a modernized language design.

Why?

Fast

Native binary compiled with OCaml. Consistently 2-4x faster than jq across file sizes and operations.

File Size Speed vs jq
< 10KB 2.4-3x faster
100-500KB 2-4.5x faster
> 500KB 1.6-3.3x faster

See detailed benchmarks

Easier to Learn

Designed to be learnable without leaving your terminal:

  • Interactive REPL with context-aware autocomplete—type . to see keys, | to see functions
  • Helpful error messages that tell you why something failed and how to fix it
  • Built-in function reference: query-json --functions lists all functions by category
$ query-json ".naem" <<< '{"name": "Alice", "age": 30}'
error[key_not_found]: key `naem` not found
  --> .naem
      ^^^^

  in: {"name": "Alice", "age": 30}
  available keys: name, age
  hint: use `.naem?` for optional access

Compare to jq

$ jq ".naem" <<< '{"name": "Alice", "age": 30}'
null
query-json interactive REPL demo

Portable

Written in OCaml, it compiles to both native code and JavaScript. Use the same query language:

  • As a CLI tool on macOS, Linux, and Windows
  • In the browser via our online playground
  • As a Node.js library: npm install @davesnx/query-json

jq, but better

We love jq's core ideas, but most of their design is arcane and forced the be backwards compatible. We looked into it with fresh eyes and came up with some improvements:

The old jq names still work but show deprecation warnings. See the full jq Compatibility Guide for details.

Installation

Using the install script

Check the content of scripts/install.sh before running anything in your local. Friends don't let friends curl | bash.

curl -sfL https://query-json.pages.dev/install.sh | bash

Using npm

npm install --global @davesnx/query-json

Download from GitHub

Pre-built binaries for macOS, Linux, and Windows are available on the releases page.

Quick Start

Query a file

query-json '.store.books[0].title' bookstore.json

Query from stdin

curl -s https://api.github.com/users/ocaml | query-json '{name: .name, description: .bio, img: .avatar_url}'

Query inline JSON

query-json '.users | length' '{"users": [1, 2, 3]}'

Common operations

# Get all keys from an object
query-json 'keys' config.json

# Filter array elements
query-json '.items | map(select(.price > 100))' products.json

# Transform data
query-json '.users | map({name, email})' users.json

# Group and count
query-json 'group_by(.category) | map_values(length)' items.json

# String operations
query-json '.title | to_lowercase | split(" ") | first' article.json

Documentation

CLI Options

query-json [OPTIONS] <QUERY> [FILE]

Arguments:
  <QUERY>    The query to run
  [FILE]     JSON file to query (reads from stdin if omitted)

Options:
  -r, --raw-output    Output strings without quotes
  -c, --no-color      Disable colored output (default when stdout isn't a terminal)
  -C, --color         Force colored output, even when stdout isn't a terminal
  --stream-output     Print each result of `.[] | ...` as soon as it is ready
  --repl              Start interactive REPL mode
  -v, --verbose       Show verbose output including deprecation warnings
  --debug             Print lexer tokens and AST
  --version           Print version
  --help              Print help

Color is on by default when stdout is a terminal, and off when it's piped or redirected (matching jq). The NO_COLOR environment variable (any non-empty value) disables color unless -C/--color is also given; -C always wins, and -c/--no-color always forces color off.

Contributing

Contributions are welcome! See the development setup below to get started.

Development

Requirements: opam

git clone https://github.com/davesnx/query-json
cd query-json
make init       # Create opam switch and install dependencies
make dev-core   # Build query-json
make test       # Run tests

Running the playground locally

# Terminal 1: Build and watch
make dev

# Terminal 2: Start web server
make web-dev

Support

License

MIT