wednesday docs
Docs/Reference

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#

VerbWhat 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.
listThe queue, optionally filtered by status.
retry --id <taskId>Retry a task.
cancel --id <taskId>Cancel a task.
scanThe commit-time secret gate.
team ...Staff the seats (see Crews & shapes).
setupRegister the MCP server with your client.

Add --json to any verb for machine-readable output (raw Hermes JSON).

Create and run a task#

a full CLI run
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#

queue controls
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#

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#

VariableEffect
HERMES_TASKS_PATHThe task store file.
FACTORY_EVENTS_PATHThe event log file.
FACTORY_EXECUTION_MODEExecution mode for the engine.
WEDNESDAY_STATE_HOMEMoves the whole state directory.

More provider and pricing variables are on Configuration.