cache clear
Remove non-sensitive caches (BFF compat, access gate, version check, GET responses). Preserves config.json (tokens) and logs/ (audit trail).
Destructive action
This command modifies or deletes data irreversibly.
Deletes the CLI's local non-sensitive caches under ~/.simetrik/: the BFF compatibility cache
(bff_compat.json), the CLI access-gate cache (cli_access.json), the update-check cache
(latest_version.json), and any cached GET responses under cache/. It prints how many files it
removed and never touches config.json (your tokens) or logs/ (the audit trail), so it does not
log you out.
Reach for this when the CLI behaves as if it's seeing stale server state — for example a workspace
that should have CLI access keeps getting denied (a stuck allowed:false in the access cache), or a
compatibility/version warning persists after an upgrade. It is the cache-only counterpart to a full
re-login: clearing caches forces the next command to revalidate against the BFF, whereas
simetrik login / simetrik logout manage credentials. The command only removes files that exist,
so running it when there is nothing cached simply reports No caches to clear.
See also: simetrik doctor, login, logout. Requires CLI access to the workspace. See permissions.
Examples
simetrik cache clearExit codes
| Code | Meaning |
|---|---|
0 | Caches cleared (or nothing to clear) — reports how many files were removed |