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.
About the plugin that serves it
Section titled “About the plugin that serves it”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).
The OCI-transport surface (charly cache push <name> <ref> / pull) moves
a named spec/cache.ArtifactStore (an OCI Image Layout) to and from a
registry, reaching candy/plugin-oci’s verb:oci cache-push/cache-pull over
the F10 peer-dispatch leg — the go-containerregistry transport stays
single-homed in plugin-oci, never linked here. Needs the compiled-in
placement (the reverse channel).
charly --help prints the command tree, including where cache is invoked and under which parent.