openstock/skills/openstock-agent-cli/references/commands/cache/guide.md

openstock cache

Purpose

Inspect and prune local cache under ~/.config/openstock/cache.

Subcommands

Command	Purpose
openstock cache status	Show cache size and namespace summary.
openstock cache prune [--dry-run]	Apply cache retention policy.

IO

Direction	Data
File read	Cache directories.
File delete	Old cache files unless --dry-run is used.
External IO	none
Side effect	prune deletes files unless dry-run.

Output Fields

Field	Meaning
root	Cache root path.
exists	Whether cache root exists.
total_files	Number of cache files.
total_bytes	Total cache size.
namespaces	Cache namespace summaries.
dry_run	Whether prune only reported actions.
deleted_files	Number of deleted files.
deleted_bytes	Bytes removed.
reports	Prune reports by namespace.

Agent Notes

Run cache prune --dry-run before destructive pruning unless the user clearly asks to clean cache.