---
type: Attested Computation
title: jq
identifier: data/jq
description: Slice, transform, filter, and extract JSON data using jq query expressions on JSON text or JSON files.
pack: data
tags:
- engineering
- computation
runtime: fragletc
image: ofthemachine/python3@sha256:a015b4f9f0e7c1648f8fcd4164f6a296dd3c9189404f88f333a9764d08d13522
network: none
stdin: buffer
execution_class: hermetic
procedure_hash: sha256:fae52da25dfdf89ac4d3a99c48cb7c7aef03a674c3f2dac5eef5d5b4e5190820
parameters:
- name: filter
  type: string
  required: true
  description: jq filter expression, e.g. .items[].name
- name: json_source
  type: file
  required: false
  description: Host JSON file mounted at /input/json_source
- name: json_text
  type: string
  required: false
  description: Inline JSON text (or pipe stdin)
computation: https://tools.ofthemachine.com/data/jq.py
executor:
  resource: https://github.com/ofthemachine/fraglet
  receipt:
  - schema
  - fragletc
  - procedure
  - procedure_hash
  - image
  - image_digest
  - network
  - stdin_mode
  - params
  - inputs
  - argv
  - env
  - memo_key
  - started
  - finished
  - exit_code
  - stdout
  - outputs
  format: fraglet-receipt/2 (fragletc --receipt <path>, or FRAGLETC_RECEIPT_DIR)
attester:
  resource: https://tools.ofthemachine.com/receipt/attest.py
  method: 'deterministic, no re-execution: procedure_hash equals sha256 of computation; memo_key recomputes from the receipt''s own fields; claimed params and any artifact hash match the receipt'
generated:
  by: process:tools/catalog/compile.py
  at: '2026-11-13T18:27:40Z'
---

# jq

Slice, transform, filter, and extract JSON data using jq query expressions on JSON text or JSON files.

Use when the user wants to filter, reshape, or pull fields out of JSON, or an API payload needs trimming before it enters context.

# Schema

## Parameters
- `filter` (string, required) — jq filter expression, e.g. .items[].name
- `json_source` (file, optional) — Host JSON file mounted at /input/json_source
- `json_text` (string, optional) — Inline JSON text (or pipe stdin)
- stdin (optional) — piped input is read in full and hashed into the run's receipt

## Outputs
- stdout (the anonymous result)

# Execution

The computation is [`data/jq.py`](https://tools.ofthemachine.com/data/jq.py) (frontmatter `computation`; in `tools.tar.gz` the same file sits at `data/jq.py` beside this bundle), run by `fragletc` in `ofthemachine/python3@sha256:a015b4f9f0e7c1648f8fcd4164f6a296dd3c9189404f88f333a9764d08d13522` with network `none`. Its identity is `procedure_hash` = sha256 of that file, shebang included — the same value every receipt records. Parameters are passed as `-p name=value`; `--receipt run.json` (or `FRAGLETC_RECEIPT_DIR`) writes the receipt, a `fraglet-receipt/2` JSON document with the fields listed under `executor.receipt`.

# Attestation

A run's receipt is attested with [`receipt/attest.py`](https://tools.ofthemachine.com/receipt/attest.py): the computation that ran is this script (`procedure_hash`), the receipt is internally consistent (`memo_key` recomputes from its own fields), the claimed parameters are the ones that ran, and an artifact claimed as an output hashes to what the receipt recorded. No re-execution: attestation is provenance fidelity, not reproduction.

Hermetic: no network, so `memo_key` also fully determines the outputs — a re-run with the same inputs must reproduce them, which makes results from this tool safely memoizable.

Skill: [SKILL.md](https://tools.ofthemachine.com/data/SKILL.md)
