name: sbx kit push
synopsis: Push a kit artifact to an OCI registry
experimental: true
description: |-
    Package and push a kit artifact directory to an OCI registry.

    The directory must contain a valid spec.yaml. The reference should be
    in the format "registry/repo:tag" (e.g., "ghcr.io/myorg/my-plugin:1.0").

    The OCI artifact format is selected from the kit's spec.yaml:
      schemaVersion: "1"  → legacy ZIP-based artifact
      schemaVersion: "2"  → v2 tar+gzip layer with the spec in the manifest
                            config blob and standard OCI annotations (so
                            distribution tooling can read kit metadata
                            without pulling layers)

    Authentication uses the Docker credential store.
usage: sbx kit push DIRECTORY REFERENCE [flags]
options:
    - name: help
      shorthand: h
      default_value: "false"
      usage: help for push
inherited_options:
    - name: debug
      shorthand: D
      default_value: "false"
      usage: Enable debug logging
see_also:
    - sbx kit - (Experimental) Manage kit artifacts
