GitHub agentic workflows
Write agentic workflows in natural language markdown, and run them safely in GitHub Actions. From GitHub Next (opens in new tab) and Microsoft Research.
Quick start
Ready to get your first agentic workflow running? Follow our step-by-step Quick Start Guide (opens in new tab) to install the extension, add a sample workflow, and see it in action.
Overview
Learn about the concepts behind agentic workflows, explore available workflow types, and understand how AI can automate your repository tasks. See How It Works (opens in new tab).
How it works
GitHub Agentic Workflows transforms natural language markdown files into GitHub Actions that are executed by AI agents. Here’s a simple example:
---
on:
issues:
types: [opened]
permissions: read-all
safe-outputs:
add-comment:
---
# Issue Clarifier
Analyze the current issue and ask for additional details if the issue is unclear.
The gh aw cli converts this into a GitHub Actions Workflow (.yml) that runs an AI agent (Copilot, Claude, Codex, …) in a containerized environment whenever a new issue is opened in the repository.
The AI agent reads your repository context, understands the issue content, and takes appropriate actions – all defined in natural language rather than complex code.
Security Benefits: Workflows use read-only permissions by default, with write operations only allowed through sanitized safe-outputs. Access can be gated to team members only, ensuring AI agents operate within controlled boundaries.
Documentation
For complete documentation, examples, and guides, see the Documentation (opens in new tab).