Skip to content

state/ and cache/

Both directories are written by runs, ignored by the scaffolded .gitignore, and safe to delete.

Repo-visible state derived from runs:

PathContents
state/api-requests.jsonCaptured API requests that matched no mock route.
state/api-mocks.suggested.ymlSuggested mock routes generated from captures, ready to move into api-mocks.yml.
Session, status, and artifact filesChain session records, status check facts, and artifact state that commands like overwire status and overwire chain show read back.

state/ lives in the repo (rather than the machine-level cache) so that scenario tooling can see it next to the config that produced it, while staying out of version control.

Local actions/cache entries when the project is configured to use the project cache (run --workflow-cache-dir defaults here when --config-root is set). Delete freely; workflows repopulate it.

Machine-level caches (action sources, tool cache, run store) live under ~/.cache/overwire/ instead. See Directory layout.

overwire.io

Overwire is not affiliated with, endorsed by, or sponsored by GitHub, Inc., Microsoft Corporation, or Docker, Inc. GitHub and GitHub Actions are trademarks of GitHub, Inc.