tidwall/jj is tracked by TopGit as an open-source project, with 2.1k stars on GitHub, written primarily in Go. JSON Stream Editor (command line utility)
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
JJ is a command line utility that provides a fast and simple way to retrieve or update values from JSON documents.
It's powered by GJSON and SJSON under the hood.
It's fast because it avoids parsing irrelevant sections of json, skipping over values that do not apply, and aborts as soon as the target value has been found or updated.
Getting started
Install
Mac (Homebrew)
brew install tidwall/jj/jj
Build
make
Or download a pre-built binary for Linux, OSX, Windows, or FreeBSD.
Usage
$ jj -h
usage: jj [-v value] [-purOD] [-i infile] [-o outfile] keypath
examples: jj keypath read value from stdin
or: jj -i infile keypath read value from infile
or: jj -v value keypath edit value
or: jj -v value -o outfile keypath edit value and write to outfile
options:
-v value Edit JSON key path value
-p Make json pretty, keypath is optional
-u Make json ugly, keypath is optional
-r Use raw values, otherwise types are auto-detected
-n Do not output color or extra formatting
-O Performance boost for value updates
-D Delete the value at the specified key path
-l Output array values on multiple lines
-i infile Use input file instead of stdin
-o outfile Use output file instead of stdout
keypath JSON key path (like "name.last")
Examples
Getting a value
JJ uses a path syntax for finding values.
Get a string:
$ echo '{"name":{"first":"Tom","last":"Smith"}}' | jj name.last
Smith
Get a block of JSON:
$ echo '{"name":{"first":"Tom","last":"Smith"}}' | jj name
{"first":"Tom","last":"Smith"}
The path syntax for setting values has a couple of tiny differences than for getting values.
The -v value option is auto-detected as a Number, Boolean, Null, or String.
You can override the auto-detection and input raw JSON by including the -r option.
This is useful for raw JSON blocks such as object, arrays, or premarshalled strings.
Update a value:
$ echo '{"name":{"first":"Tom","last":"Smith"}}' | jj -v Andy name.first
{"name":{"first":"Andy","last":"Smith"}}
Set a new value:
$ echo '{"name":{"first":"Tom","last":"Smith"}}' | jj -v 46 age
{"age":46,"name":{"first":"Tom","last":"Smith"}}
No homepage URL was recorded for tidwall/jj in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How many stars does tidwall/jj have?
tidwall/jj has 2.1k GitHub stars — refresh the page for the live number, or check github.com/tidwall/jj. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is tidwall/jj open source?
Yes — tidwall/jj ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/tidwall/jj.
What is tidwall/jj?
tidwall/jj (tidwall/jj) is a Go project on GitHub. From the project's own README: JSON Stream Editor (command line utility)
Where do I read more about tidwall/jj?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/tidwall/jj is the definitive source.
Read full README in the tab above.
Still deciding about jj?
One click hands the question to an AI along with this page — see what it says about jj.