OSS探訪ページ内ナビ
概要
yqは、jqに似た式でYAMLを中心とする構造化データを検索、変換、更新するGo製CLIです。単一の実行ファイルとして配布され、複数ファイルの結合、直接更新、形式変換をシェルやCIへ組み込めます。
特徴と向いている用途
公式資料に基づく紹介・実機未検証 · 内容確認日：
主な特徴
一つの式で複数の構造化データ形式を処理する
YAML、JSON、XML、CSV、TSV、TOML、properties、HCLを読み取り、項目の選択、更新、結合、別形式への出力をCLIから実行できます。
出典：[1]
向いている用途
設定ファイルをシェルやCIで検査・変換したい作業に向く
Kubernetesマニフェストやアプリケーション設定を処理の流れの中で抽出・検証し、専用スクリプトを増やさず小さな変換を再現したい場合に使えます。
出典：[1]
導入前の確認
v3以前との構文差と直接更新の破壊性を確認する
現行v4は過去のメジャー版とコマンド構文が異なります。-iはファイルを書き換えるため、対象形式、式、出力結果を標準出力で確認してからバージョン管理下で使う必要があります。
出典：[1]
参考にした公式資料
- [1]yq v4.54.1 README(2026-10-04)
- [2]yq v4.54.1 release(2026-10-04)
- [3]yq v4.54.1 license(2026-10-04)
編集部からの補足
v4の式と形式の自動判定を小さなサンプルで確認し、直接更新ではバージョン管理とバックアップを併用してください。
3ステップで試す
- 1
v4.54.1を専用ディレクトリへビルドする
システム全体のパスを変更せず、確認済みタグから実行ファイルを作ります。
mkdir -p yq-demo/bin && GOBIN="$PWD/yq-demo/bin" go install github.com/mikefarah/yq/v4@v4.54.1 - 2
固定した版を確認する
実行対象がv4.54.1であることを確認します。
./yq-demo/bin/yq --version - 3
サンプルYAMLを読み取りだけで検索する
元のファイルを書き換えず、入れ子になった値の抽出結果を確認します。
printf "services:\n api:\n image: example:v1\n" > yq-demo/sample.yml && ./yq-demo/bin/yq ".services.api.image" yq-demo/sample.yml
成長
成長の推移 · 直近30日
16,049 Stars
推移データを蓄積中です。
開発アクティビティ
直近90日・週次
- Commit（直近30日）
- 27
- Open PR
- 57
開発アクティビティを蓄積中です。
Built with
カテゴリとタグ
GitHubデータ
関連情報
関連記事を投稿するこのOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。
あわせて探訪
- Ollama182,132 Stars
共通タグ 1件 · 共通カテゴリ 1件 · 同じ言語
オープンモデルの取得、実行、API連携を一つのローカル基盤へまとめる
Go - fzf83,368 Stars
共通タグ 1件 · 共通カテゴリ 1件 · 同じ言語
stdinやfile walkerの候補を曖昧検索し、preview・shell action・remote controlまで組めるterminal fuzzy finder
Go - Lazygit82,880 Stars
共通タグ 1件 · 共通カテゴリ 1件 · 同じ言語
stage・commit・branch・rebase・worktree・reflog操作をkeyboard中心のterminal UIへ集約するGit client
Go - mkcert59,717 Stars
共通タグ 1件 · 共通カテゴリ 1件 · 同じ言語
localhostや開発用domain向けにローカルCAを作成し、ブラウザから信頼されるTLS証明書を簡単に発行する
Go - GitHub CLI46,526 Stars
共通タグ 1件 · 共通カテゴリ 1件 · 同じ言語
pull request・issue・repository・GitHub APIの操作を
Goghから実行し、terminal中心の開発workflowへ統合する - duf15,336 Stars
共通タグ 1件 · 共通カテゴリ 1件 · 同じ言語
ファイルシステムの空き容量を見やすい表で確認し、JSONでも取り出す
Go
情報の誤りを報告
掲載内容に誤りや古い情報があればお知らせください。