homepage: https://github.com/mikefarah/yq
tagline: |
yq: a lightweight and portable command-line YAML processor
-
---
+To update or switch versions, run `webi yq@stable` or `webi yq@beta`, etc.
+
+## Cheat Sheet
+
+> `yq` is like [`jq`](../jq), meaning that it's like `sed` for YAML data - you
+> can use it to slice and filter and map and transform structured data with the
+> same ease that `sed`, `awk`, `grep` and friends let you play with text.
+
+Usage: `yq e '<selector>' <filepath>`
+
+Works with YAML:
+
+```bash
+echo 'name: John' | yq e '.name' -
+```
+
+Works with JSON:
+
+```bash
+echo '[ { "name": "John" }, { "name": "Jane" } ]' | yq e '.[].name' -
+```
+
+See <https://mikefarah.gitbook.io/yq/> for the docs.