Gojq

gojq Plugin

Pure Go implementation of jq. Process and query JSON data with jq-compatible syntax.

Commands

JSON Querying

• gojq query json — Query JSON with jq syntax

Utility

• gojq _ _ — Passthrough to gojq CLI

Usage Examples

• "Query this JSON"
• "Filter JSON data"
• "Extract field from JSON"
• "Transform JSON structure"

Installation

brew install gojq

Or via Go:

go install github.com/itchyny/gojq/cmd/gojq@latest

Examples

# Extract field
echo '{"foo": 128}' | gojq query json '.foo'

# Nested field
echo '{"a": {"b": 42}}' | gojq query json '.a.b'

# Array elements
echo '[{"id":1},{"id":2},{"id":3}]' | gojq query json '.[] | .id'

# Object construction
echo '{"id": "sample", "10": {"b": 42}}' | gojq query json '{(.id): .["10"].b}'

# Math operations
echo '{"a":1,"b":2}' | gojq query json '.a += 1 | .b *= 2'

# Large number precision
echo '{"foo": 4722366482869645213696}' | gojq query json '.foo'

# Filter array
echo '[1,2,3,4,5]' | gojq query json '.[] | select(. > 3)'

# Map over array
echo '[1,2,3]' | gojq query json 'map(. * 2)'

# Sort array
echo '[3,1,2]' | gojq query json 'sort'

# Any gojq command with passthrough
gojq _ _ '.foo' < data.json
gojq _ _ -r '.name' < data.json

Key Features

• jq compatible - Same query syntax as jq
• Pure Go - No C dependencies
• Large numbers - Arbitrary precision integers
• Error messages - Clear and helpful errors
• JSON validation - Validates JSON input
• Streaming - Process large JSON files
• Cross-platform - Works everywhere
• Fast - Efficient Go implementation

Notes

• Query syntax is jq-compatible
• Use -r for raw output (no quotes)
• Supports all jq filters and functions
• Great for API response processing
• Can be used in shell scripts