Development Utilities — Clean Cache
srb clean removes SRB, Isaac Sim, or SimForge caches. Use it after framework
upgrades or asset changes. Cache identity defaults source and asset digests to
unattested when their digest environment variables are unset.
SRB and Isaac roots require a versioned ownership marker bound to canonical path, device and inode. Claim fixed roots before cleaning:
srb cache claim-clean-root --target srb
srb cache claim-clean-root --target isaacsim
Existing content can be adopted only at the repository .cache, five Isaac
vendor roots, and selected NGC profile root. NGC adoption rejects top-level entries outside the expected Docker profile
directories (cache, compute, kit, logs, config, data, pkg,
hub).
A custom SRB_NGC_CACHE_DIR is selected only when absolute. After Docker
chowns the root to UID 1234, claim it as a user with write access. A populated
custom SRB_CACHE_ROOT is never adopted: create and claim a new empty root
before writing cache data. Clear old marked roots after simulator upgrades.
Usage
srb clean [TARGET ...] [-y/--yes]
Targets are all (default), srb, isaacsim or simforge; all selects all
three. -y/--yes skips confirmation only. SimForge rejects forwarded tokens
after -- with exit code 2; a failed, timed-out or unexpected SimForge clean
makes the command exit 1.
--yes does not bypass ownership, root-depth, repository/home, mount, symlink,
device or entry-identity checks. Removal uses anchored directory descriptors
and preserves the cache root and marker.
What Gets Removed
| Target | Affected paths |
|---|---|
srb | Selected root: source checkout <repository>/.cache; when installed, absolute $XDG_CACHE_HOME/srb, otherwise ~/.cache/srb. SRB_CACHE_ROOT overrides it. |
isaacsim | Marker-owned ~/.cache/isaac-sim, ~/.cache/ov, ~/.cache/nvidia/GLCache, ~/.nv/ComputeCache, ~/.cache/packman, and ${SRB_NGC_CACHE_DIR:-~/.cache/space_robotics_bench/ngc/isaac-sim-6.1/<arch>} (amd64 or arm64, per .docker/run.bash). |
simforge | Delegated to simforge clean for generated assets; SRB does not recursively remove its directory. |
.docker/run.bash mounts these roots under ~; .docker/hpc/run.bash mounts
them under ${SCRATCH:-$HOME}/volumes/<repository>/. For the HPC profile, set
SRB_NGC_CACHE_DIR to its NGC root
(${SCRATCH:-$HOME}/volumes/<repository>/ngc/isaac-sim-6.1/<arch>) before
srb cache claim-clean-root --target isaacsim or srb clean isaacsim.
srb clean isaacsim warns about present but unclaimed roots.
~/.cache/nvidia/GLCache and ~/.nv/ComputeCache are shared with CUDA/OpenGL
applications; ~/.cache/ov is shared with Omniverse. Clearing marked roots is
safe, but those applications rebuild their caches on next use.