Browse & manage assets

This guide starts after you have logged in. For how references and submit-time pins work, read Asset Catalogs & Version Pinning.

Discover assets

Your organization

simulo asset list
simulo asset list --kind robot

Simulo global catalog

simulo asset list --global
simulo asset list --global --kind world

Search both

simulo asset search warehouse
simulo asset search arm --kind robot

simulo asset list shows the first 20 entries in catalog order (kind, then name) by default. On that command, use --all for every match, --limit N for an explicit cap, or --json for automation. JSON list output with no explicit limit retrieves the complete result set rather than silently truncating it.

simulo asset search always spans both catalogs and retrieves all matching pages. It has no --all or --limit option; --json changes only the output format.

Normal list and search results hide an asset whose latest live version is deprecated. The list-only flag below includes those assets; it does not expose every older deprecated version:

simulo asset list --deprecated

Use simulo asset inspect <ref> for the complete version history of one asset.

Inspect identity, versions, and validation

An unpinned ref selects the current latest version; use :vN when the exact version matters:

simulo asset inspect robot/my-arm
simulo asset inspect robot/my-arm:v1
simulo asset inspect simulo/robot/cartpole:v1

If the newest version is still being validated, wait for its result and show the finished report with one command:

simulo asset inspect robot/my-arm --wait

Press Ctrl-C to stop watching. Validation continues in the cloud, so you can run the same command again later.

The summary includes entry path, package digest, source format, validation history, measured facts, use count, and version history. Save the complete machine record or validation report separately:

simulo asset inspect robot/my-arm:v1 --json > my-arm.record.json
simulo asset inspect robot/my-arm:v1 --report my-arm.validation.json

The JSON record contains version.facts; the report contains the staged check rows. See Asset Validation before using either as a CI gate.

Download an organization-owned version

simulo asset get robot/my-arm:v1

The client verifies the archive digest and writes the package under the colon-free cache layout ~/.simulo/assets/<publisher>/<kind>/<name>/vN/. This is useful for inspection and local execution. Global catalog assets are usable by cloud jobs but deliberately not exportable with asset get.

Deprecate and reactivate

Lifecycle commands require an exact version:

simulo asset deprecate robot/my-arm:v1
simulo asset reactivate robot/my-arm:v1

Deprecation does not rewrite or break existing pinned jobs. New submits warn; simulo run --strict-assets turns that warning into an error.

Delete with the history guard intact

simulo asset delete robot/my-arm:v1

The normal form refuses deletion while any job references the version. Prefer deprecation when you only want to stop new use.

Force delete is permanent

simulo asset delete robot/my-arm:v1 --force is limited to your own organization’s assets. It removes the version and stored package even when past jobs reference it; those job records retain a deleted-asset tombstone. Global assets refuse this operation. Use it only when permanent removal is the actual goal.

For every option, see the generated simulo asset CLI reference.