yq

Name: yq
Brand: yq

A lightweight, portable command-line YAML processor

softwareDevOps & CI/CDYAMLCommand-lineData Processing

Visit Website

Our Verdict

Best for

Developers needing fast, scriptable YAML edits in CI/CD

Skip if

Users requiring rich GUI or beginner-friendly jq tutorials

What is yq?

yq is a fast, portable command-line tool for querying, editing, and transforming YAML files. It works across platforms and integrates seamlessly into CI/CD pipelines, making YAML manipulation simple for developers and DevOps engineers. Built on Go, yq offers a familiar jq‑like syntax while supporting advanced YAML features such as anchors, aliases, and multi‑document streams. Its zero‑dependency binary can be used locally or in container images, enabling consistent YAML handling across environments.

SpecificationsAI-estimated

deploymentSelf-hosted

open source✅ Yes

github stars15,740

api available❌ No

support optionsEmail, GitHub Issues

primary languageGo

Key Features of yq

yq can read, write, and modify YAML files using concise jq‑style expressions, reducing the need for custom scripts.

It supports in‑place editing of files, allowing direct updates without creating temporary copies.

Multi‑document YAML streams are handled natively, enabling batch operations across several documents in a single file.

The tool provides powerful filtering, mapping, and aggregation functions for complex data transformations.

yq can convert between YAML, JSON, and TOML formats, facilitating interoperability between different configuration languages.

Streaming mode lets yq process large YAML files efficiently without loading the entire document into memory.

Integration with standard Unix pipelines makes it easy to combine yq with other command-line utilities.

Built-in support for YAML anchors and aliases ensures that advanced YAML features are preserved during transformations.

Use Cases for yq

CI/CD configuration updates

Automatically bump version numbers or modify deployment settings in pipeline YAML files.

Kubernetes manifest management

Batch edit resource definitions across multiple manifests before applying them to a cluster.

Data migration scripts

Transform legacy YAML configuration into new schema versions during automated migrations.

Ad‑hoc debugging

Quickly query and extract values from large YAML logs or config files on the command line.

Pros & Cons of yq

Pros

Free and open source
Runs on all major OSes
Zero external dependencies
Familiar jq‑like syntax

Cons

Limited GUI support
Complex expressions can become hard to read
Documentation sometimes assumes prior jq knowledge

Frequently Asked Questions

What file formats does yq support?

yq natively handles YAML and can convert to/from JSON and TOML.

Do I need to install any runtime?

No, yq is distributed as a single static binary for each platform.

Can yq be used in Docker containers?

Yes, the binary can be added to any container image and used in CI/CD pipelines.

Is there a graphical interface available?

yq is a command-line tool only; there is no official GUI.

Pricing Overview

View full pricing →

Free

Detailed plans are not listed. Visit the official website for pricing information.

Reviews & Ratings0.0

Write a Review See all reviews →

No reviews yet. Be the first to write one!

Top Alternatives & Similar Tools

View all alternatives & similar tools →

No alternatives available yet.

yq