Skip to content

gz chores run

Execute one chore and append a dated log entry.

Usage

Bash
gz chores run <slug>

Runtime Behavior

  • Executes only steps[*].argv arrays declared in the chore's acceptance.json / CHORE.md, resolved via the project-first → package-fallback resolver (ADR-0.0.21): <project_root>/.gzkit/chores/<slug>/ first, then importlib.resources.files("gzkit.chores") as the package fallback.
  • Refuses shell-string command definitions (command) to keep execution deterministic.
  • Writes a dated entry to: .gzkit/chores/<slug>/proofs/CHORE-LOG.md (project-local execution evidence is never canonical).
  • Returns non-zero on command failure, timeout, or missing executable.

Example

Bash
uv run gz chores run quality-check