<!-- source: https://cli.dreamlake.ai/libraries @ 0.134.0 99837ab -->

# Asset library files

`dl library push` discovers assets from a source directory, with optional
`dreamlake.yml` configuration. See the [library guide](https://docs.dreamlake.ai/libraries)
for authoring and [reference](https://docs.dreamlake.ai/libraries/reference) for
manifest and read-path contracts.

Within an asset directory, discovery preserves the `.metadata/` and `.thumbs/`
payload directories used by NVIDIA SimReady. Their regular files remain at their
original relative paths and keep their original bytes; this preserves provenance
and authored previews. Inclusion does not interpret a physics configuration or
prove that its model loads in MuJoCo.

Other dot-leading files and directories remain excluded, including `.env`,
`.git/` and generated `.dreamlake/` state. The two exceptions apply only to
directories, not hidden files with those names. Hidden entries inside them are
still filtered under the same rules, and symlinks are not followed. Explicit
`discover.exclude` patterns continue to take precedence, including exclusions
of `.metadata` or `.thumbs`. There is no general include-hidden switch.

This corrects older CLI discovery, which skipped both payload directories.
Previously published manifests remain unchanged; repushing with this behavior
can add the retained files and change asset digests. Inspect the resulting
manifest/file counts before replacing a published library. For a complete raw
repository archive, separately verify its source layout: library discovery is
an asset-selection operation, not an unconditional copy of every hidden file.
