kenyonj/Mark Ready When Ready
Automatically marks a draft PR as ready for review once all required checks pass. Label it, walk away, come back ready.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit May 7, 2026
- License
- MIT
Pinned Snippet
uses: kenyonj/mark-ready-when-ready@164bebf98862a24419165413a00bab80107b25ad # v1.3.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| github-token | A GitHub token with permission to read checks/statuses and write to pull requests and contents. Can be GITHUB_TOKEN (with contents: write permission) or a GitHub App token. | yes | — |
| label | The label that triggers the action. | no | Mark Ready When Ready |
| pause-seconds | Seconds to pause between the first and second round of check verification. This helps catch late-arriving or re-triggered checks. | no | 20 |
| polling-interval-seconds | Seconds between REST API polls when the fallback is active. Lower values detect completion sooner but use more API calls. | no | 10 |
| polling-timeout-seconds | Maximum seconds to wait for checks during REST API fallback polling. The fallback activates automatically on private repos where the GraphQL-based gh pr checks is restricted. | no | 1800 |
| remove-label | Whether to remove the trigger label after marking the PR ready. | no | true |
Outputs
| name | description |
|---|---|
| result | Outcome of the action: "ready" if the PR was marked ready, "failing-checks" if required checks failed, "conflicting" if the PR has merge conflicts, or "skipped" if preconditions were not met. |
| failing-checks | Names of required checks that failed (if any). |