← Back
GitHub
GitHub launches Agentic Workflows in technical preview, enabling AI-driven repository automation in Markdown
GitHub CopilotGitHub ActionsGitHub · releasefeatureapiplatformintegration · github.blog ↗

Intent-Driven Automation in Markdown

GitHub Agentic Workflows simplify repository automation by replacing complex YAML configuration with natural language Markdown descriptions. Instead of hand-crafting GitHub Actions workflows, developers can now describe their automation goals in plain English, and AI agents intelligently convert these descriptions into executable workflows.

How It Works

Developers add Markdown files to .github/workflows/ that describe what they want to automate. The gh aw CLI extension compiles these natural language descriptions into standard GitHub Actions workflows. These workflows execute using GitHub Copilot CLI or other compatible AI coding agents, with support for multiple triggers including issue/PR events, schedules, manual dispatch, and comment-based invocation.

Security-First Architecture

The platform prioritizes security with several built-in safeguards:

  • Read-only by default: Workflows have minimal permissions out of the box
  • Sandboxed execution with network isolation
  • SHA-pinned dependencies to prevent supply chain attacks
  • Sanitized write operations through preapproved "safe outputs"

Capabilities and Integration

Agentic Workflows come with deep GitHub platform integration through the GitHub MCP Server, providing native access to repositories, issues, pull requests, actions, and security features. Additional tools include browser automation, web search, and support for custom MCP integrations.

Developers can create, edit, debug, and optimize workflows using AI agents directly in VS Code, github.com, or their preferred coding environment. The entire implementation is open source under the MIT license at github/gh-aw.

Getting Started

The feature is available immediately through the gh aw CLI extension. GitHub provides comprehensive documentation and reference implementations through Peli's Agent Factory, which showcases over 50 specialized workflows for common use cases like issue triage, CI failure investigation, documentation maintenance, and test coverage improvement.