charly cmd
| Served by | plugin-cmd |
| Placement | compiled-in (in-process) |
| Version | 2026.209.0000 |
cmd is a command word served by the plugin-cmd 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”COMPILED-IN charly COMMAND-class plugin owning the externalized charly cmd command
(#118 loader+check-tail cone) — run a single command in a running container with an
optional desktop notification on completion.
The plugin owns the command end to end: the kong grammar (CmdCmd), the container resolve
(deploykit.ResolveContainer / ResolveSidecarContainer), and –notify (the venue’s gdbus
session-bus call, driven directly on the deploykit.ContainerChain executor — a plugin
drives gdbus itself, the boundary law’s host-object-is-never-permanence rule). The ONE
thing it cannot do is the interactive exec, which is deploy-lifecycle machinery
(dispatchLifecycleTarget → OpAttach): it drives the hidden charly __cmd core reentry
over the generic HostBuild(“cli”) seam with INHERITED stdio, so the -i interactive
stream reaches the operator. The __cmd handler stays core (deploy-lifecycle-coupled
RESIDUE, gated on that coupling relocating), NOT a plugin — so no charly-core symbol
crosses the boundary; the plugin imports the sdk module alone.
cmd is COMPILED-IN (listed in charly/charly.yml compiled_plugins) BECAUSE its Invoke(OpRun) needs the in-proc reverse channel — threaded by dispatchInProcCommand — to drive HostBuild(“cli”). The out-of-process CliMain path has no reverse channel, so it errors. command:cmd is a FLAT command (Box + Command positionals), so NewMeta declares no Subcommands and ships no plugin_input.
Run charly cmd --help for the live flag grammar.