Operator CLI
The same engine without a client open. The CLI is the operator’s surface for tasks, crews, setup and the security scan.
Verbs#
| Verb | What it does |
|---|---|
create --objective "..." | Register a task (Hermes is the task store). |
run --id <taskId> | Run it through plan, build, verify, repair, review. |
watch --id <taskId> | Live stages. |
status --id <taskId> | Current state. |
events --id <taskId> | The event log. |
result --id <taskId> | The receipt. |
list | The queue, optionally filtered by status. |
retry --id <taskId> | Retry a task. |
cancel --id <taskId> | Cancel a task. |
scan | The commit-time secret gate. |
team ... | Staff the seats (see Crews & shapes). |
setup | Register the MCP server with your client. |
Add --json to any verb for machine-readable output (raw Hermes JSON).
Create and run a task#
wednesday create --objective "add a quantity input to the cart page" \
--workspace ./shop \
--tests "npm test" \
--acceptance "quantity validates on submit"
wednesday run --id <taskId>
wednesday watch --id <taskId>
wednesday result --id <taskId>
create also accepts --role, --stack, --required-files, and --id. Pipe-separated lists are accepted for tests, acceptance and required files.
The queue#
wednesday list
wednesday list --status failed
wednesday retry --id <taskId>
wednesday cancel --id <taskId>
Task state is persisted by Hermes. The MCP job ids are a separate, in-memory layer over the same runs.
The security scan#
wednesday scan # scan the repo you are standing in
wednesday scan --repo ./other # scan another repository
wednesday scan --install-hook # block a bad commit before it exists
--install-hook writes .githooks/pre-commit and sets core.hooksPath, so the gate travels with the repo. It scans what is staged and uses the same rules that block a leaked secret in a Wednesday run. A pass means no secret shape and no dangerous call shape — never no vulnerability.
--allow-findings (or WEDNESDAY_SCAN_ALLOW=1) reports the finding and says it is now part of the history. git commit --no-verify bypasses everything.
CLI configuration#
| Variable | Effect |
|---|---|
HERMES_TASKS_PATH | The task store file. |
FACTORY_EVENTS_PATH | The event log file. |
FACTORY_EXECUTION_MODE | Execution mode for the engine. |
WEDNESDAY_STATE_HOME | Moves the whole state directory. |
More provider and pricing variables are on Configuration.