GitHub Agentic Workflows: AI automation for repositories
Write AI workflows in natural language markdown that execute as GitHub Actions with built-in safety controls.
Learn more about GitHub Agentic Workflows
GitHub Agentic Workflows is a GitHub CLI extension that converts natural language markdown specifications into executable GitHub Actions workflows. The system translates human-readable workflow descriptions into automated tasks that can perform repository operations, code analysis, and other GitHub-related activities. Workflows run in sandboxed environments with read-only permissions by default, using sanitized outputs and multiple security layers including network isolation and SHA-pinned dependencies. Common applications include automated code reviews, repository maintenance tasks, and CI/CD pipeline management through conversational interfaces.
Natural Language Workflows
Workflows are written in plain markdown rather than YAML or code. The system interprets natural language descriptions and converts them into executable GitHub Actions.
Multi-Layer Security
Implements sandboxed execution, input sanitization, network isolation, and tool allow-listing. Workflows run with read-only permissions by default with human approval gates for critical operations.
GitHub Actions Integration
Executes workflows through the existing GitHub Actions infrastructure. Includes companion projects for network egress control and Model Context Protocol routing.
gh aw new auto-triage-issues
gh aw compile auto-triage-issues
git add .github/workflows/auto-triage-issues.md .github/workflows/auto-triage-issues.lock.yml
git commit -m "Add auto-triage workflow"
git pushThis release focuses on improved developer experience with smarter error messages, richer MCP tooling metadata, broader ecosystem support, and a more
- –Daily repo chronicle posts to Announcements** (#16930) — Fixed the discussion category for the daily-repo-chronicle workflow to correctly target the Announcements category.
- –MCP SDK upgraded to v1.3.1** (#16923) — `github.com/modelcontextprotocol/go-sdk` updated to the latest security patch release.
- –Brotli pre-compression guide for WASM binary** (#16913) — New documentation covers how to configure brotli pre-compression for the WASM binary to optimize load performance.
- –[log] Add debug logging to 5 Go files in pkg/cli and pkg/workflow by @github-actions[bot] in
- –Add hover documentation tooltips for frontmatter keys in Playground
This release brings an exciting new AI engine option, a better mobile experience in the Playground, and internal quality improvements to keep workflow
- –Google Gemini CLI engine (experimental)** — You can now use Google's Gemini CLI as an agentic engine for your workflows. Set `engine: gemini` in your workflow frontmatter to try it out. (#16894)
- –Mobile-friendly Playground** — The Playground editor now uses a tab-based layout on mobile devices, making it much easier to author and test workflows on smaller screens. (#16784)
- –OSS dependency security scanning** — A new daily workflow runs safedep/vet-action to continuously audit open-source dependencies for vulnerabilities. (#16891)
- –Safe-outputs staged mode** — Fixed 31 handlers that were missing the 🎭 emoji in staged mode output, ensuring consistent visual feedback across all safe-output types. (#16893)
- –Code blocks in the Creating Workflows guide now use the `wrap` attribute for improved readability on narrow screens. (#16901)
This release focuses on quality and reliability improvements: better audit visibility, smarter issue management, and a handful of user-facing fixes th
- –Auto-close Older Issues** (#16843) — The CLI version checker's safe-output config now includes `close-older-issues`, automatically cleaning up stale version notices so your issue tracker stays tidy.
- –macOS ARM64 Container Smoke Tests** (#16742) — Container validation now runs on macOS ARM64, expanding platform coverage and catching ARM-specific issues earlier.
- –Fix false positive numeric validation** (#16809) — `github.event.head_commit.id` expressions no longer incorrectly trigger numeric validation warnings during compilation.
- –Cleaner CLI help text** (#16839) — Resolved 5 inconsistencies in CLI help text output, making command documentation clearer and more reliable.
- –Workflow normalizer deduplication** (#16844) — Per-workflow issues are now consolidated into a single issue per run, eliminating duplicate noise in repositories with active normalization workflows.
See how people are using GitHub Agentic Workflows
Top in Cloud & DevOps
Related Repositories
Discover similar tools and frameworks used by developers
Azure CLI
Cross-platform CLI for managing Azure resources through commands and automation scripts.
ProxmoxVE
Bash scripts for automated Proxmox LXC/VM provisioning.
OpenZFS
Enterprise filesystem with volume management, data integrity, snapshots, and compression.
Proxmox VE Helper-Scripts
Shell scripts that automate Linux container and VM creation on Proxmox VE with interactive configuration dialogs.
Kaniko
Daemon-free Docker image builder for Kubernetes clusters.