gojq

name	gojq
description	Use this skill when the user wants to query JSON data, filter JSON, transform JSON with jq syntax, or process JSON files.

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