GitHub Agentic Workflows let you automate repository tasks using AI agents that run within GitHub Actions. Write workflows in plain Markdown instead of complex YAML, and let AI handle intelligent decision-making for issue triage, pull request reviews, CI failure analysis, and repository maintenance.

By adding Markdown files to .github/workflows/, you can describe automation goals in natural language. The gh aw CLI converts these into standard GitHub Actions workflows that execute using GitHub Copilot CLI or other coding agents. Workflows run with read-only permissions by default and use preapproved “safe outputs” for write operations.

The feature is available in technical preview through the gh aw CLI extension.

Demo

Key benefits

  • Natural language workflows: Write automation in Markdown instead of YAML. Describe what you want in natural language, and the AI agent figures out how to do it.
  • Security-first design: Read-only by default with sandboxed execution, network isolation, SHA-pinned dependencies, and sanitized write operations through safe outputs.
  • Multiple coding agents: Works with GitHub Copilot CLI (default) or other AI coding agents. Same workflow format across all engines.
  • Deep GitHub integration: Native access to repositories, issues, pull requests, actions, and security through the GitHub MCP Server. Additional tools for browser automation, web search, and custom MCPs.
  • Flexible triggers: Respond to issues and pull request events, run on schedules, dispatch manually, or invoke via commands in comments.
  • Easy to start: Install the CLI extension, create a Markdown file, compile, and commit. They run as standard GitHub Actions.
  • Agentic authoring: Create, edit, debug, and optimize workflows using AI agents in VS Code, github.com, or your preferred coding agent.
  • Open source: Fully open source on GitHub under the MIT license. Community contributions are welcome.

Examples

Imagine repository automation that automatically triages incoming issues, investigates root causes of CI failures, maintains documentation, improves test coverage, monitors compliance, and even boosts team morale. With agentic workflows, you define these behaviors in simple Markdown files.

Not sure where to begin? Check out Peli’s Agent Factory which showcases over 50 specialized agentic workflows for different use cases.

Getting started

Learn more by reading the GitHub Agentic Workflows documentation. See what others are building, join the discussion and share your thoughts and feedback in the Community and in the GitHub Next Discord.

GitHub Agentic Workflows are a collaboration among GitHub Next, Microsoft Research, and Azure Core Upstream. The implementation is open source on GitHub in the gh-aw repository.

Read more on the GitHub Blog post introducing Agentic Workflows.