Question 1

How to use groq-cli with NDJSON files?

Accepted Answer

Use the --ndjson flag or set --input ndjson when piping NDJSON data, such as 'cat file.ndjson | groq --ndjson "*[_type == \"post\"]"'. This processes each line as a separate JSON object for streaming efficiency.

Question 2

groq-cli vs jq: which is better for JSON querying?

Accepted Answer

groq-cli excels with GROQ's expressive syntax for complex queries and schema validation, while jq is more established, with a simpler syntax for basic tasks and a larger community. Choose groq-cli for advanced manipulations in Node.js environments.

Question 3

Can groq-cli handle large JSON files efficiently?

Accepted Answer

Yes, groq-cli supports streaming via NDJSON to process large files without loading everything into memory. For monolithic JSON, performance depends on Node.js and query complexity, but it's optimized for pipe-based workflows.

Question 4

How to validate JSON schema with groq-cli?

Accepted Answer

Use the --schema flag with a path to a schema file and set --output type-nodes, e.g., 'groq --schema schema.json --output type-nodes "*"'. This validates results against the schema and provides type information.

Question 5

Is groq-cli available on package managers other than npm?

Accepted Answer

Currently, groq-cli is primarily installed via npm globally, as per the README. There's no mention of alternative package managers, so Node.js and npm are required for setup.

Question 6

What are common GROQ query examples for groq-cli?

Accepted Answer

Common queries include filtering with '*[condition]', projecting fields with '{title, author}', and counting with 'count(posts)'. Refer to Sanity's GROQ documentation for more patterns like joins and sorting.

GROQ

What is GROQ?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Open Source Alternative To

Frequently Asked Questions