task
| Served by | plugin-task |
| Placement | compiled-in (in-process) |
| Version | 2026.267.2313 |
task is a command word served by the plugin-task 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 generic declarative TASK runner for charly — the replacement for a
Taskfile. Serves three task capabilities plus four generic maintenance
verbs. Task capabilities: kind:task (a named, host-native, REUSABLE plan
authored as a task: node in charly.yml, using the SAME #Step/#Op grammar a
candy’s plan uses), command:task (charly task [list] [<name>] [--dry-run] [--json] [--param k=v] [--all]), and verb:task (compose a declared task
into a candy/box/task plan). The engine reuses kit.RunPlan + a
checkkit.VerbResolver over kit.ShellExecutor{} — the SAME engine
candy/plugin-check drives — so there is no second execution engine. Any task
a repository needs (build, test, lint, release, verify, notify) is a task
entity; the task body is the base-schema #Task, validated host-side against
#TaskValue (a task’s plan: [...#Step] references the base #Step grammar,
which a self-contained plugin schema cannot carry).
Four GENERIC, domain-neutral MAINTENANCE verbs replace repository shell
scripts, each parameterized by the repo’s own data (paths/pairs/pins) so the
plugin stays reusable by any repository: verb:git-submodules (status/bump/
verify .gitmodules pins, incl. the policy-B comparison of a repo’s pins
against a pinned checkout’s gitlinks), verb:file-parity (check/sync that
paired files are byte-identical), verb:splice-region (splice a marked
region from a fragment into a target), and verb:module-pins (adopt a
source go.mod’s require pins across every module a glob matches, then tidy).
COMPILED-IN by default (the command needs the host’s loaded project over the reverse channel; the maintenance verbs are host-native and act on the checkout); the kind/verb capabilities also serve out-of-process.
charly --help prints the command tree, including where task is invoked and under which parent.