CLI overview

The CLI is the scriptable companion to the desktop app. Both run the same engine, share the same .overwire/ config, and write to the same run store.

overwire [options] [command]

Command	Purpose
init	Scaffold a flat .overwire/ config tree
doctor	Health-check Node, the container engine, and your config
parse	Parse a workflow YAML file and print its structure
list	List workflows with their triggers and jobs
lint	Lint a workflow file for common issues
explain	Explain how Overwire would support a workflow without running it
simulate	Print a simulated event payload
run	Execute a workflow locally, mock by default
chain	Run or inspect workflow-chain scenario sessions
resolve	Fetch and parse an action’s action.yml
seed-mocks	Write a mock contract for every uses: in a workflow
status	Show latest workflow and check status for a ref or SHA
history	List recent workflow runs for the current project
cache	Inspect or clear the action cache

Most commands accept --config-root <dir> to point at a .overwire/ directory outside the current working directory. When the config root is some/repo/.overwire, the project identity derives from some/repo.