Development Utilities — Clean Cache

The srb clean command removes cached files associated with SRB itself, Isaac Sim, and SimForge. This is the recommended way to recover from stale caches after framework upgrades or asset changes.

SRB and Isaac cache directories must first carry a versioned ownership marker bound to their canonical path, device, and inode. Claim the fixed cache roots explicitly:

srb cache claim-clean-root --target srb
srb cache claim-clean-root --target isaacsim

The fixed repository-local .cache and the listed Isaac cache paths may adopt existing content. A populated custom SRB_CACHE_ROOT is never adopted. Create and claim a new empty custom root before writing cache data instead.

Usage

srb clean [TARGET ...] [-y/--yes]

Selecting all (the default) is equivalent to specifying the srb, isaacsim, and simforge targets. Trailing tokens after -- are forwarded to simforge clean when the simforge target is included.

--yes bypasses only the prompt. It never bypasses ownership, root-depth, repository/home, mount, symlink, device, or entry-identity checks. Removal uses anchored directory descriptors and preserves the cache root and its marker.

What Gets Removed

The delegated SimForge command retains SimForge’s own ownership policy. SRB does not recursively remove its directory.

Examples

Remove all caches with confirmation:

srb clean

Remove only SRB caches without prompting:

srb clean srb -y

Remove only the Isaac Sim Omniverse caches:

srb clean isaacsim -y

Forward extra arguments to SimForge:

srb clean simforge -y -- --asset-name my_asset

Reference: SimForge CLI — simforge clean