What problem does it solve?
Quickly parse, extract, filter, and transform JSON from the command line so that developers and automation scripts can handle API responses, logs, and other JSON payloads without heavy tooling or custom parsing code.
Core Features & Use Cases
- Lightweight CLI parsing: Use concise filters to extract fields, navigate nested objects, and produce compact or pretty output.
- Stream and transform: Process large JSON streams, map and aggregate records, sort and group data, and convert arrays into structured outputs for downstream tooling.
- Shell integration: Integrate with curl, CI pipelines, and shell scripts to extract IDs, validate JSON, and generate tabular outputs for reporting.
- Real-world example: extract the first result id from an API response in a CI job, fail the job on missing fields, and produce a compact JSON summary for downstream steps.
Quick Start
Pipe the API response into jq and extract the first result id using a filter like .results[0].id with -r to return raw text.