command: docker buildx history rm
short: Remove build records
long: |-
    Remove one or more build records from the current builder’s history. You can
    remove specific builds by ID or offset, or delete all records at once using
    the `--all` flag.
usage: docker buildx history rm [OPTIONS] [REF...]
pname: docker buildx history
plink: docker_buildx_history.yaml
options:
    - option: all
      value_type: bool
      default_value: "false"
      description: Remove all build records
      details_url: '#all'
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
inherited_options:
    - option: builder
      value_type: string
      description: Override the configured builder instance
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
    - option: debug
      shorthand: D
      value_type: bool
      default_value: "false"
      description: Enable debug logging
      deprecated: false
      hidden: false
      experimental: false
      experimentalcli: false
      kubernetes: false
      swarm: false
examples: |-
    ### Remove a specific build

    ```console
    # Using a build ID
    docker buildx history rm qu2gsuo8ejqrwdfii23xkkckt

    # Or using a relative offset
    docker buildx history rm ^1
    ```

    ### Remove multiple builds

    ```console
    # Using build IDs
    docker buildx history rm qu2gsuo8ejqrwdfii23xkkckt qsiifiuf1ad9pa9qvppc0z1l3

    # Or using relative offsets
    docker buildx history rm ^1 ^2
    ```

    ### Remove all build records from the current builder (--all) {#all}

    ```console
    docker buildx history rm --all
    ```
deprecated: false
hidden: false
experimental: false
experimentalcli: false
kubernetes: false
swarm: false

