Chock.sh Build your plugin

CLI reference

chock resume

Ask the user before running chock resume: what it takes and prints, from the engine at the pinned commit.

Lift a stop: agents are judged by the policies again

Syntax

This is the usage line argparse builds from this command's parser.

chock resume [-h] [--repo REPO] [--everywhere]

Arguments and options

The table lists every argument the parser declares, except -h, --help, written as argparse prints it. Default is the value the parser uses when you leave the option out. It is empty for a flag or when the parser sets none.

ArgumentDefaultHelp
--repo REPO.Repo root (default: cwd)
--everywhereLift the machine-wide stop only

Exit codes

  • 2: argparse rejected the arguments, for example an option this command does not have. The site's tests run every command with an unknown option and check that it exits 2.
  • Chock documents no other exit codes. Each example below shows the code its run returned.

Examples

Real runs, recorded by python -m sitegen.cliexamples with the engine at the pinned commit. The steps of data/cli-examples.yaml ran in order, offline, in one fresh git repository at /work/demo (made with git init -b main), with HOME at /home/demo. Those paths stand for the throwaway folders the runs used, and <time> stands for a timestamp. Output is stdout and stderr together.

Step 20 of 21, exit code 1.

$ chock resume
chock resume: refused: it needs a person at a terminal (stdin and stdout are not a TTY). Run `chock resume` yourself, in your own terminal.

Help as printed

This is what --help prints, from the same parser. The usage line names the program as the engine's parser does.

usage: chock resume [-h] [--repo REPO] [--everywhere]

Remove `.chock/stop.json`: agents' tool calls, commits and pushes are judged by the policies
again.

options:
  -h, --help    show this help message and exit
  --repo REPO   Repo root (default: cwd)
  --everywhere  Lift the machine-wide stop only

Built from engine 5a4b6287a46e and catalog 1e60d211c1bb.