Skip to content

cache

Served by plugin-cache
Placement compiled-in (in-process)
Version 2026.248.0001

cache is a command word served by the plugin-cache plugin candy. This plugin is listed in charly/charly.yml’s compiled_plugins:, so its providers are compiled into the charly binary and register in-process.

The charly cache command — the git-ref cache operator surface, served as a charly COMMAND-class plugin (dual-placement: compiled-in + external). On charly cache status|clear|refresh|bypass, the plugin operates on the git-ref cache DIRECTLY through spec/refs (the same per-host charly.yml cache: section the core singleton uses — shared on-disk state). The bypass (charly cache bypass) is PERSISTED in the cache: git: section via refs.GitClient.SetBypass, so a fresh core process honors it at construction — the plugin owns the whole operator surface; core keeps only the mechanism (spec/refs) + the singleton. The command-class companion of the verb-class plugin-example-external; the command class is external-capable: charly prescans cache into the CLI grammar and dispatches it in-proc (compiled-in) or fork/execs this binary (external).

charly --help prints the command tree, including where cache is invoked and under which parent.