v0.53.0
π Release Highlights
This release focuses on reliability and polish β fixing a cluster of real-world bugs reported by the community while strengthening core workflows around PR creation, model configuration, memory persistence, and the upgrade experience.
β¨ What's New
- Configurable activation token β The
on:section now supportsgithub-tokenandgithub-appfields, letting you use a custom PAT or GitHub App token for activation-job reactions and status comments. (#19427) - Graceful PR-permission fallback β When GitHub Actions lacks permission to create PRs,
create_pull_requestnow opens a fallback issue with a one-click link to open the PR manually, so your pushed branch is never left dangling. (#19466) - Strategy schema for custom jobs β The
strategyfield (withmatrix,fail-fast,max-parallel) is now fully usable in custom job definitions, and strategy values are properly extracted by the compiler. (#19405) - Workflow call ID in comments β The
add_commentaction now appends agh-aw-workflow-call-idmarker to comments when a caller workflow ID is present, enabling better cross-workflow traceability. (#19525) - Smarter history link types β Generated GitHub search URLs now include a
type=parameter scoped to the correct content type (issues, PRs, discussions), reducing irrelevant results. (#19507)
π Bug Fixes & Improvements
gh aw upgradeSHA-pinssetup-cliβ Upgrade now writes a SHA-pinned reference for thesetup-cliaction instead of a bare version tag, consistent with all other action references. (#19496)- Copilot model path fixed β The fallback model configuration now correctly uses the
COPILOT_MODELenvironment variable instead of the unsupported--modelCLI flag, making org-level model overrides work as expected. (#19509) push_repo_memoryretry/backoff β Concurrent agents racing on the repo-memory branch no longer cause non-fast-forward failures; the push step now retries with exponential backoff and a job-level concurrency group. (#19494)- ENOENT noise eliminated β Pre-agent failures (sandbox crash, network timeout) no longer cause downstream ENOENT errors from a missing agent-output artifact. Failure issues also now include richer context in their title. (#19505)
runtime-importin.githubrepos β Compiling a workflow inside a repository literally named.githubno longer produces duplicated paths like.github/.github/workflows/β¦. (#19518)safe-inputsscript runner fixed β Thescript:runner for safe inputs was always returning{"stdout":"","stderr":""}instead of actual output; the generated.cjsnow correctly callsexecute()when run as a subprocess. (#19493)- stderr suppressed in non-git directories β
get_current_branch.cjsno longer leaksfatal: not a git repositoryto stderr when invoked outside a git repo. (#19499) - MCP audit error clarity β Debug log lines are now filtered from the
audittool error response, so callers see the actual error instead of a wall of internal diagnostics whenDEBUG=*is set. (#19506)
π Documentation
- Updated docs for the new
on.github-tokenandon.github-appactivation fields. (#19502) trial-ops.mdtrimmed by 24% β same content, much easier to scan. (#19478)
π Community Contributions
A huge thank you to the community members who reported issues that were resolved in this release:
@MatthewLabasan-NBCUfor Bug: gh-aw compile incorrectly prepends repository name to #runtime-import paths in .github repositories (#19500)@samuelkahessayfor push_repo_memory.cjs has no retry/backoff, fails on concurrent pushes (#19476)@samuelkahessayfor get_current_branch.cjs leaks stderr when not in a git repository (#19475)@samuelkahessayfor Unconditional agent-output artifact download causes ENOENT noise on pre-agent failures (#19474)@samuelkahessayfor Copilot engine fallback model path uses --model CLI flag instead of COPILOT_MODEL env var (#19473)@dsymefor "GitHub Actions is not permitted to create or approve pull requests." (#19465)@rspurgeonfor Bug: gh aw upgrade does not set a sha for setup-cli in copilot-setup-steps.yml (#19451)
For complete details, see CHANGELOG.
Generated by Release
What's Changed
- Fix unusable strategy schema for custom jobs + add compiler extraction (Option B) by @Copilot in #19405
- [log] Add debug logging to 5 pkg/ files by @github-actions[bot] in #19455
- create_pull_request: create fallback issue with one-click PR link on permission error by @Copilot in #19466
- [instructions] Sync github-agentic-workflows.md with v0.40.1 by @github-actions[bot] in #19470
- [docs] Consolidate developer specs: fix 3 tone issues, bump dev.md to v3.5 by @github-actions[bot] in #19472
- [docs] docs: unbloat trial-ops.md (24% reduction) by @github-actions[bot] in #19478
- Add configuration for activation GitHub token by @Copilot in #19427
- [docs] Update documentation for on.github-token and on.github-app fields from 2026-03-04 by @github-actions[bot] in #19502
- fix: suppress stderr in get_current_branch.cjs when outside a git repo by @Copilot in #19499
- refactor: extract common CLI install/build codegen for maintenance workflow run_operation job by @Copilot in #19498
- fix(conformance): USE-001 standardized error codes + USE-003 staged mode emoji by @Copilot in #19497
- fix: SHA-pin setup-cli action reference in copilot-setup-steps.yml on upgrade by @Copilot in #19496
- fix: retry/backoff for push_repo_memory + job-level concurrency group by @Copilot in #19494
- fix(mcp): filter debug log lines from audit tool error response by @Copilot in #19506
- Fix safe-inputs
script:runner always returning{"stdout":"","stderr":""}by @Copilot in #19493 - Fix ENOENT noise from unconditional agent-output env var and add pre-agent failure context to issue title by @Copilot in #19505
- Fix copilot fallback model path to use COPILOT_MODEL env var instead of --model flag by @Copilot in #19509
- Update history link generation to set type in search query by @Copilot in #19507
- Fix runtime-import path duplication when repo is named
.githubby @Copilot in #19518 - [aw] Updates available by @github-actions[bot] in #19527
- [WIP] Update generated footer to include gh-aw-workflow-call-id by @Copilot in #19525
Full Changelog: v0.52.1...v0.53.0