Skip to main content
r3 caches memories in two tiers and processes writes asynchronously by default. These tools let you inspect cache health, tune what stays hot, and confirm that async writes have finished. See Memory Tools for storing and retrieving memories.

​
cache_stats

View cache performance metrics and health status. Use for monitoring and debugging. Returns: Summary text with cached memory count.

​
optimize_cache

Reorganize cache for optimal hit rates. Promotes frequently accessed memories to L1 (24h TTL) and demotes cold data to L2 (7d TTL).
​
boolean
true clears cache and reloads all from storage. false optimizes existing cache. Default: false.
​
number
Maximum memories to keep in cache. Range: 100-10000. Default: 1000.
Returns: Summary of cached memories.

​
sync_status

Check the background job queue and sync status. Shows pending async operations from add_memory calls. Returns: Count of pending operations, or All operations complete.

Memory Tools

Store, retrieve, search, and manage memories.

Configuration

Set storage backends and cache priorities.
Last modified on September 20, 2026