# kislyuk/yq

Command-line YAML, XML, TOML processor - jq wrapper for YAML/XML/TOML documents

Repository: https://github.com/kislyuk/yq
Canonical: https://ross.abutalabs.com/products/kislyuk-yq
Homepage: https://kislyuk.github.io/yq/
Language: Python
License: Apache-2.0
License Family: permissive
Topics: yaml, jq, command-line, json, yml, xml, cli
Last push: 2026-07-11T17:52:40+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 92, release rhythm 92, longevity 100
- inputs: {"age_days": 3519, "days_push": 53, "days_rel": 53, "gap_med": 0, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2971, forks 85 (observed 2026-08-28T04:07:32.771275+00:00)

## What it is
A Python command-line tool that wraps jq to let you query and transform YAML, XML, and TOML documents using jq syntax. It converts input to JSON, pipes it through jq, and can convert output back to YAML with options for round-trip preservation of tags, styles, and in-place editing.

## Use cases
- query yaml files with jq syntax
- convert json to yaml from the command line
- edit kubeconfig yaml in place
- extract fields from xml documents in a shell script
- process toml config files with jq filters
- preserve yaml comments and tags while transforming files

## When to choose
- you already know jq and want the same query language for YAML/XML/TOML
- you need in-place editing of YAML config files from scripts
- you want round-trip preservation of YAML tags, styles, and comments
- you need JSON-to-YAML or YAML-to-JSON conversion in pipelines

## When to avoid
- you want a standalone tool without installing the jq binary dependency
- you need a Go-based yq with its own native syntax and no external dependencies
- you need to process formats other than YAML, XML, or TOML

## Facets
- artifact type: cli-tool
- maturity: active
- function: parser, cli, developer-tools, serialization
- domain: developer-tools, files
- platform: cli, python, cross-platform, windows
- tags: yaml, xml, toml, jq, json-conversion, config-files, command-line, macos, linux

## Member repositories
- kislyuk/yq (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:32.771275+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:31:43.266981+00:00, confidence not recorded.
  - readme: https://github.com/kislyuk/yq (fetched 2026-08-28T04:07:32.771275+00:00, sha d3b35cd98af2)
  - homepage: https://kislyuk.github.io/yq/ (fetched 2026-08-29T09:47:00.027801+00:00, sha cac1768a7237)
  - registry_pypi: https://pypi.org/pypi/yq/json (fetched 2026-08-29T09:47:00.037965+00:00, sha bf3fa6be0fa7)
- Data as of 2026-08-30T08:39:29.467469+00:00.