yq
Portable command-line processor for YAML, JSON, XML, CSV, TOML and other formats.
Tested on Linux
Use it
Linux x86_64
install yq binary via curl to ~/.local/bin
curl -L https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64 -o ~/.local/bin/yq && chmod +x ~/.local/bin/yq
Check that it works
yq --versionThe output should contain “yq (https://github.com/mikefarah/yq/) version v4.54.1”.
First thing to try
cat > /tmp/file.yaml <<'EOF'
a:
b:
- c: hello
d: world
EOF
cat /tmp/file.yaml
cat > /tmp/sample.json <<'EOF'
{"name": "mike", "age": 30, "pets": ["cat", "dog"]}
EOF
cat /tmp/sample.json
cat > /tmp/file1.yaml <<'EOF'
a: 1
b: 2
EOF
cat > /tmp/file2.yaml <<'EOF'
b: 3
c: 4
EOF
cat /tmp/file1.yaml
cat /tmp/file2.yaml
echo "setup done"yq '.a.b[0].c' /tmp/file.yamlWhat it does
- Read values with jq-like expressionsTested
- Update YAML files in placeTested
- Convert between YAML JSON XML formatsTested
- Merge multiple files togetherTested
How far pickfit got
Linux x86_64
- Installs
- Starts
- 4 of 4 features work
- Works offline
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
An alternative to jq.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 4 Nov 2026
- Version v4.54.1
Differences the test machine hit
- README: wget https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64 -O /usr/local/bin/yq && chmod +x /usr/local/bin/yq
In the test: use curl to download to ~/.local/bin/yq (wget not installed and /usr/local/bin requires root; ~/.local/bin is on PATH) - README: install step 1 runs yq
In the test: nothing to change; a note: the box ran yq, downloaded, without reading it first, so pickfit did not inspect it