Download: v1.2.2v1.2.2 ↓1.2.22026-11-10
+3
Daily
5,639
stars
628
forks
55
watchers
25,010
prs
40,371
issues
501
releases

README

GitHub Agentic Workflows


Agent quick links

Hello fellow agent! Welcome to GitHub Agentic Workflows = Actions + Agent + Safety.
Here are some pointers to get you started in using this tool.

- Create a new workflow: https://raw.githubusercontent.com/github/gh-aw/main/create.md
- Install: https://raw.githubusercontent.com/github/gh-aw/main/install.md
- Package a workflow repository: https://raw.githubusercontent.com/github/gh-aw/main/package.md
- Reference: https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md



GitHub Agentic Workflows (gh-aw) lets developers define AI-powered repository automation in Markdown with YAML frontmatter and run AI agents securely through GitHub Actions. The gh-aw GitHub CLI extension compiles each agentic workflow into a standard GitHub Actions workflow.

Use conventional GitHub Actions for deterministic builds, tests, linting, deployments, and reproducible scripts. Add an agentic workflow when a task needs reasoning or interpretation, such as issue triage, pull-request review, CI failure investigation, documentation maintenance, dependency analysis, or repository reporting. GitHub Agentic Workflows complements existing CI/CD; it does not replace it.

Built-in AI engines include GitHub Copilot, Claude Code, OpenAI Codex, Google Gemini, and Pi. Agent jobs are read-only and sandboxed by default, and configured GitHub writes are normally applied through validated safe-outputs jobs with scoped permissions.


 Contents

- Quick Start
- How Agentic Workflows work
- Security and permissions
- Documentation
- Contributing
- Community Contributions
- Related Projects
- Workshop

 [!NOTE]
 A security vulnerability was discovered in versions = 0.83.3, /...
- go build ./cmd/linters
- make golint-custom

make golint-custom builds cmd/linters and runs the custom analyzers against ./cmd/... and ./pkg/....



 🌍 Community Contributions

Community members whose issues were resolved — updated automatically.

@a-sjogren-accenture (2)
@aaronspindler (1)
@abbottships (3)
@abillingsley (2)
@adam-cobb (1)
@adamhenson (2)
@adamtasteslikegood (1)
@Adarsh1999 (1)
@adhikjoshi (1)
@aharper-srsacquiom (1)
@ahmadabdalla (1)
@ajfeldman6 (2)
@akkikumar72 (1)
@AkshatRaj00 (1)
@alanpeabody (1)
@alcastaneda (1)
@AlexanderWert (1)
@AlexDeMichieli (1)
@alexsiilvaa (2)
@alirezamirian (1)
@alondahari (19)
@alvistar (2)
@AmoebaChant (1)
@AnandhaSivam-00 (1)
@anthonyhull-ford (2)
@anthonymastreanvae (11)
@aoxiangtianyu-go (1)
@apenab (1)
@arabkin (1)
@arezero (6)
@Arithmomaniac (1)
@arthurfvives (8)
@Artur- (1)
@asatara (1)
@askpaisa (1)
@askpt (1)
@astefan (1)
@awoisoak (1)
@b-dantas (1)
@b2pacific (1)
@babaakihiro (2)
@bartul (1)
@bbonafed (23)
@beardofedu (1)
@beingminimal (1)
@benissimo (20)
@BenjaminMichaelis (1)
@benvillalobos (12)
@bindsi (1)
@bjartenilsen (1)
@blavity-machine-user (1)
@blozano-tt (11)
@bmerkle (3)
@boydj (2)
@Bra1nFartz (1)
@BrandonLewis (1)
@brendanlapuma (1)
@bryanchen-d (25)
@bryanknox (1)
@

Top issues

Discussions

Latest release

v1.2.2 v1.2.2 2026-11-10
🌟 Release Highlights

This release focuses on more reliable work-queue handling, hardened firewall/proxy egress, and sturdier session normalization across engines.

 ✨ What's New

- Cancel obsolete work: cancel-work --obsolete adds a read-only dry-run preview, and queue maintenance now cancels obsolete worker backlog.
- Cost-aware model routing: more workflows (including PR Sous Chef) use economy model routing instead of pinned models.
- Skip-if-decision gates added to ten more Copilot workflows and AWF engine invocations to cut unnecessary runs.
- Name-based artifact upserts in updat

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON