yq is a command-line processor for YAML, JSON, XML, CSV, TOML, HCL, and properties files.
The tool addresses the need to query, transform, and convert structured data formats from the command line. It adopts jq-like syntax, making it familiar to users of that popular JSON processor, but extends that approach to work across multiple formats. This means developers can use consistent query and transformation patterns whether working with YAML configuration files, JSON APIs, XML documents, or other structured formats without learning different tools for each.
Teams should choose yq when they need to manipulate configuration files or structured data in shell scripts and automation pipelines. It suits DevOps workflows, infrastructure-as-code projects, and any scenario involving batch processing of multiple formats. The tool is particularly valuable for those already comfortable with jq syntax who need to work with YAML or other formats. It is distributed as a single, dependency-free binary for multiple platforms, making it straightforward to integrate into CI/CD systems, containers, and deployment scripts without additional installation overhead.
The project maintains active development with regular additions to supported operations and functions. The tool has broad distribution across multiple installation channels including package managers, Docker, and direct binary downloads. Documentation is comprehensive, with recipes and examples provided alongside formal API documentation. Community engagement is evident through discussion forums addressing common questions and showcasing use cases.
