GStars
    mikefarah

    mikefarah/yq

    yq is a portable command-line YAML, JSON, XML, CSV, TOML, HCL and properties processor

    cli
    devops
    bash
    csv
    devops-tools
    golang
    hcl
    Go
    MIT
    16.3K stars
    1.3K forks
    62 GitHub watchers
    Updated Nov 10, 2026
    View on GitHub

    Build with Backblaze B2

    SDKs, agent skills, IDE extensions, and reference pipelines from Backblaze Labs. All open source.

    Explore Backblaze Labs

    Loading star history...

    Where it stands

    Rank, growth pace and release cadence relative to everything GStars tracks.

    5 releases in the last 90 days, the latest 1 day ago, with 162 contributors on GitHub.

    Peaked at #71 in the weekly ranking the week of Aug 16, its best in the past year.

    Use Cases & Benefits

    • Processes and transforms YAML, JSON, XML, CSV, TOML, HCL, and properties files via a portable command-line interface.
    • Offers jq-like syntax with multi-format support and in-place editing while preserving formatting and comments.
    • Use for automating configuration file updates in DevOps pipelines across diverse data formats.
    • Use for converting between data serialization formats like JSON to YAML or XML to TOML in scripting workflows.
    • Use for querying and manipulating complex nested data structures in configuration files for infrastructure as code.

    Should you depend on it?

    License terms, project hygiene and risks, from GitHub metadata and GStars' snapshots.

    License

    MIT

    Permissive: commercial use, modification and redistribution are allowed with attribution.

    Community files

    • README: present
    • Contributing guide: present
    • Code of conduct: present

    Watch-outs

    No watch-outs from GStars' checks.

    General guidance from repository metadata, not legal advice. How we score

    From the README

    A lightweight and portable command-line YAML, JSON, INI and XML processor. yq uses jq (a popular JSON processor) like syntax but works with yaml files as well as json, kyaml, xml, ini, properties, csv and tsv. It doesn't yet support everything jq does - but it does support the most common operations and functions, and more is being added continuously.

    yq is written in Go - so you can download a dependency free binary for your platform and you are good to go! If you prefer there are a variety of package managers that can be used as well as Docker and Podman, all listed below.

    Update a yaml file in place:

    Excerpt from the mikefarah/yq README on GitHub (MIT license). © its authors.Read the full README on GitHub

    Daily snapshots

    Stars gained per day, and how forks and open issues moved, from GStars' daily snapshots

    Aug 19: +12Aug 20: +6Aug 28: +5Sep 19: +3Sep 20: +9Sep 21: +2Sep 26: +2

    +413 stars over 85 days across 17 snapshot days; best day +12 on Aug 19.

    Forks

    1.3K+474

    Open issues

    323+29

    Compared with peers in CLI

    Fastest-growing repositories GStars tracks in this cohort for the week of Nov 8, by 7-day star growth

    View category →
    mikefarah/yq compared with CLI repositories by stars, 7-day star growth, health score and last release
    RepositoryStars+7dHealthLast release
    morluto/rea450.0K+22.9K7516 days ago
    mattpocock/skills320.9K+9.5K7512 days ago
    vercel-labs/agent-desktop21.4K+8.7K755 days ago
    stablyai/orca121.4K+6.7K75today
    vercel-labs/agent-browser49.2K+3.8K751 day ago
    mikefarah/yq16.3K—751 day ago
    Category median121.4K+8.7K75—
    Compare yq with rea, skills, agent-desktop →

    Discover Repositories

    Search across tracked repositories by name or description