GitHub Agentic Workflows | GitHub Agentic Workflows (https://github.github.io/gh-aw/) (/gh-aw/sitemap-index.xml) (https://github.github.io/gh-aw/blog/rss.xml) (Blog) (/gh-aw/favicon.svg) (/gh-aw/fonts/MonaSans-Regular.woff2) (/gh-aw/fonts/MonaSans-Bold.woff2) (/gh-aw/favicon.svg) (/gh-aw/_astro/print.DNXP8c50.css) (/gh-aw/_astro/Authors.BRgZWkO7.css) (/gh-aw/_astro/FeatureCard_astro_astro_type_style_index_0_lang.DJkAVacI.css)  Skip to content (/gh-aw/) (GitHub Agentic Workflows) GitHub Agentic Workflows     Search Ctrl K   Cancel        (/gh-aw/setup/quick-start/) Quick Start (/gh-aw/setup/creating-workflows/) Create (/gh-aw/index.html#gallery) Examples (/gh-aw/introduction/overview/) Docs (/gh-aw/reference/faq/) FAQ (/gh-aw/blog/) Blog (/gh-aw/blog/2026-01-12-welcome-to-pelis-agent-factory/) Peli's Agent Factory  (https://github.com/github/gh-aw) GitHub    (https://github.github.io/gh-aw/blog/rss.xml) RSS     Select theme (auto) (auto) Auto (dark) Dark (light) Light                 GitHub Agentic Workflows Repository automation, running the coding agents you know and love, with strong guardrails in GitHub Actions.   (/gh-aw/setup/quick-start/) Quick Start with CLI    (/gh-aw/setup/creating-workflows/) Creating Workflows       Imagine a world where improvements to your repositories are automatically delivered as pull requests each morning, ready for you to review. Issues are automatically triaged, CI failures analyzed, documentation maintained, test coverage improved and compliance monitored - all defined via simple markdown files. GitHub Agentic Workflows deliver this: repository automation, running the coding agents you know and love, in GitHub Actions, with strong guardrails and security-first design principles. Use GitHub Copilot, Claude by Anthropic or OpenAI Codex for event-triggered, recurring and scheduled jobs to improve, document and analyze your repository. GitHub Agentic Workflows are designed to (https://github.github.io/gh-aw/reference/faq/#determinism) augment your existing, deterministic CI/CD with (https://githubnext.com/projects/continuous-ai) Continuous AI capabilities GitHub Agentic Workflows has been developed by GitHub Next and Microsoft Research with guardrails in mind. Agentic workflows run with minimal permissions by default, with explicit allowlisting for write operations and sandboxed execution to help keep your repository safe. Key Features    Section titled “Key Features”   (/gh-aw/introduction/overview/#natural-language-to-github-actions)    Automated Markdown Workflows   Write automation in markdown instead of complex YAML   (/gh-aw/introduction/how-they-work/)     AI-Powered Decision Making   Workflows that understand context and adapt to situations   (/gh-aw/reference/tools/#github-tools-github)    GitHub Integration   Deep integration with Actions, Issues, PRs, Discussions, and repository management   (/gh-aw/introduction/architecture)    Safety First   Sandboxed execution with minimal permissions and safe output processing   (/gh-aw/reference/engines/)    Multiple AI Engines   Support for Copilot, Claude, Codex, and custom AI processors   (/gh-aw/introduction/how-they-work/)    Continuous AI   Systematic, automated application of AI to software collaboration    Guardrails Built-In    Section titled “Guardrails Built-In”   Workflows run with read-only permissions by default. Write operations require explicit approval through sanitized (/gh-aw/reference/glossary/#safe-outputs) safe outputs (pre-approved GitHub operations), with sandboxed execution, tool allowlisting, and network isolation ensuring AI agents operate within controlled boundaries. Example: Daily Issues Report    Section titled “Example: Daily Issues Report”   How they work:  Write - Create a .md file with your automation instructions in natural language Compile - Run gh aw compile to transform it into a GitHub Actions workflow with guardrails (.lock.yml ) Run - GitHub Actions executes your workflow automatically based on your triggers  Here’s a simple workflow that runs daily to create an upbeat status report: (/gh-aw/_astro/ec.v4551.css)  ---   on :    schedule :  daily   permissions :    contents :  read    issues :  read    pull-requests :  read   safe-outputs :    create-issue :    title-prefix :  " [team-status]  "    labels : [ report ,  daily-status ]    close-older-issues :  true   ---     ## Daily Issues Report     Create an upbeat daily status report for the team as a GitHub issue.     (Copy to clipboard)      The gh aw cli converts this into a GitHub Actions Workflow (.yml) that runs an AI agent (Copilot, Claude, Codex, …) in a containerized environment on a schedule or manually. The AI coding agent reads your repository context, analyzes issues, generates visualizations, and creates reports - all defined in natural language rather than complex code. Gallery    Section titled “Gallery”   (/gh-aw/blog/2026-01-13-meet-the-workflows-continuous-simplicity/)     Continuous Improvement   Daily code simplification, refactoring, and style improvements   (/gh-aw/blog/2026-01-13-meet-the-workflows-continuous-refactoring/)     Continuous Refactoring   Slash commands for on-demand analysis and automation   (/gh-aw/blog/2026-01-13-meet-the-workflows-documentation/)    Continuous Documentation   Continuous documentation maintenance and consistency   (/gh-aw/blog/2026-01-13-meet-the-workflows-issue-management/)    Issue & PR Management   Automated triage, labeling, and project coordination   (/gh-aw/blog/2026-01-13-meet-the-workflows-metrics-analytics/)    Metrics & Analytics   Daily reports, trend analysis, and workflow health monitoring   (/gh-aw/blog/2026-01-13-meet-the-workflows-security-compliance/)     Continuous Scanning & Compliance   Scanning, alert triage, and compliance monitoring   (/gh-aw/blog/2026-01-13-meet-the-workflows-quality-hygiene/)    Quality & Testing   CI failure diagnosis, test improvements, and quality checks   (/gh-aw/examples/multi-repo/)     Multi-Repository   Feature sync and cross-repo tracking workflows   (/gh-aw/examples/scheduled/)    Scheduled Workflows   DailyOps, research, and automated maintenance    Getting Started    Section titled “Getting Started”   Your browser doesn't support HTML5 video. Download the video (/gh-aw/videos/install-and-add-workflow-in-cli.mp4) here .    Install the extension, add a sample workflow, and trigger your first run - all from the command line in minutes. Creating Workflows    Section titled “Creating Workflows”   Your browser doesn't support HTML5 video. Download the video (/gh-aw/videos/create-workflow-on-github.mp4) here .    Create custom agentic workflows directly from the GitHub web interface using natural language.   Note GitHub Agentic Workflows is in early development and may change significantly. Using agentic workflows requires careful attention to security considerations and careful human supervision, and even then things can still go wrong. Use it with caution, and at your own risk.       Made with    by (https://githubnext.com/) GitHub Next & (https://www.microsoft.com/en-us/research/) Microsoft Research  • (https://github.com/githubnext/githubnext/blob/main/TERMS_AND_CONDITIONS.md) Terms of Service