create-workflow requires a safe repository-relative directory containing only publishable artifacts.
It refuses existing files unless --force is supplied; --dry-run never writes, including with --force.
Review generated workflows before committing them.
Check current API behavior with gh api --help and the GitHub Pages REST documentation.
# Pages deployment helper
Inspects and changes GitHub Pages through `gh api`, or scaffolds a deployment workflow.
```text
node scripts/gh_pages_deploy.mjs status owner/repo --json
node scripts/gh_pages_deploy.mjs status owner/repo --build-info
node scripts/gh_pages_deploy.mjs enable owner/repo --dry-run --json
node scripts/gh_pages_deploy.mjs rebuild owner/repo --json
node scripts/gh_pages_deploy.mjs create-workflow --site-dir dist --dry-run
node scripts/gh_pages_deploy.mjs create-workflow --site-dir dist --output .github/workflows/pages.yml
```
`create-workflow` requires a safe repository-relative directory containing only publishable artifacts.
It refuses existing files unless `--force` is supplied; `--dry-run` never writes, including with `--force`.
Review generated workflows before committing them.
Check current API behavior with `gh api --help` and the GitHub Pages REST documentation.