About | GitHub Agentic Workflows
Skip to main content About What is GitHub Agentic Workflows? Section titled “What is GitHub Agentic Workflows?” GitHub Agentic Workflows ( gh-aw ) is an open-source GitHub CLI extension from GitHub for defining AI-powered repository automation and running AI agents through GitHub Actions. Each agentic workflow combines YAML frontmatter for triggers, permissions, tools, and AI engine selection with a Markdown body containing natural-language instructions.
The gh aw compile command validates that source and generates the .lock.yml workflow that GitHub Actions executes. GitHub Agentic Workflows complements deterministic GitHub Actions workflows. Keep builds, tests, linting, deployments, and reproducible scripts deterministic; use an agentic workflow when a task needs reasoning, investigation, interpretation, or content and code generation. The supported agent-job path defaults to sandboxing and read-only permissions, with controlled write operations available through safe outputs.
Start with the GitHub Agentic Workflows quickstart , then learn how to create an agentic workflow , choose an AI engine , review the security architecture , or browse the gallery by task . Project Section titled “Project” Resource Link Repository github/gh-aw Install gh extension install github/gh-aw License MIT Changelog CHANGELOG.md Team Section titled “Team” GitHub Agentic Workflows is built and maintained by the GitHub Next team at GitHub.
Community Section titled “Community” Join GitHub Discussions for questions, ideas, and announcements, share feedback in the Community discussion , or chat in the GitHub Next Discord . Contributing and security Section titled “Contributing and security” Contributions are welcome. See CONTRIBUTING.md for setup and guidelines. For vulnerability reports, see SECURITY.md .