{
  "slug": "buildx-imagetools-supports-metadata-file-ce726e9fccfc",
  "title": "buildx imagetools supports --metadata-file",
  "tools": [
    "buildx"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-03-04T00:50:32.000Z",
  "announced_at": "2026-03-04T00:50:32.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When creating a new image from registry sources, pass `--metadata-file` to write create-result metadata, including descriptor and digest values, as JSON. The output directory must already exist and be writable.",
    "examples": [
      "docker buildx imagetools create -t <image:tag> <source1> <source2> --metadata-file <metadata.json>"
    ],
    "gotchas": [
      "Version: v0.32.0",
      "--metadata-file <string>: Write create-result metadata as JSON to the specified file.",
      "-t, --tag <image>: Set the reference for the new image.",
      "SOURCE...: Source manifests or images; they must already exist in the registry where the new manifest is created.",
      "Prerequisite: The metadata file's directory must already exist and be writable.",
      "Prerequisite: Source manifests must already exist in the registry where the new manifest is created."
    ]
  },
  "why_it_matters": "Capture descriptor or digest metadata while working with an image through imagetools.",
  "sources": [
    "https://github.com/docker/buildx/releases/tag/v0.32.0",
    "https://github.com/docker/buildx/blob/v0.32.0/docs/reference/buildx_imagetools_create.md"
  ],
  "rank": 0.94032,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave1b-20261016",
    "verdict_id": "wave1b-20261016:wave1b-20261016-82202d6b282c8aea-0:gate",
    "evidence_hash": "a093717aae38f3ae2db5ad843629331d5a1cfe55ffdbc2e7b2b8a9b38aa8104b"
  },
  "review": {
    "draft_hash": "812adf2518154d8cc14b7bf97bec6da86177ca00df54ed6395846d863d8e8a15",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-20261016:gate",
    "reason": "2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.94 >= 0.9; 2 needed) and Jev gave 0.67 (>= 0.6 needed)."
  }
}