**GitHub Agentic Workflows (gh-aw)**
FreeGitHub
FreeFree tier
LinksLinkedIn
About **GitHub Agentic Workflows (gh-aw)**
GitHub Agentic Workflows (gh-aw) is an open-source CLI tool and GitHub Actions extension that lets developers write agentic workflows in natural language markdown. The workflows can be scheduled or triggered by events and are executed within GitHub Actions, supporting multiple AI providers: GitHub Copilot, Anthropic Claude, OpenAI Codex, and Google Gemini. A quick start installs the gh aw extension, then uses gh aw init to configure a repository and gh aw add to add workflows like daily repo status reports. The tool includes guardrails for safety and security, and is maintained by GitHub under the github/gh-aw repository.
Key Features
Write workflows in natural language markdown
Run agentic workflows in GitHub Actions
Supports GitHub Copilot, Claude (Anthropic), Codex (OpenAI), and Gemini (Google)
CLI extension with commands: gh aw init, gh aw add, gh aw --create-pull-request
Scheduled workflows (e.g., daily repository status summaries)
Built-in guardrails for safety and security
Open source and free to use
Automatic pull request generation for workflow changes
Pros & Cons
Pros
- Natural language definition lowers barrier to automation
- Multiple AI provider support offers flexibility
- Seamless integration with GitHub ecosystem and Actions
- Open source with active community contributions
- Easy installation via one-liner script
- Guardrails help maintain safety in automated actions
Cons
- Requires GitHub Actions minutes (free tier available for public repos, limited for private)
- Billing bug in versions 0.68.4–0.71.3 required upgrading (fixed in later releases)
- Dependency on GitHub platform and ecosystem lock-in
- Complex workflows may still require YAML/scripting knowledge for advanced actions
Best For
Automate daily repository status reports (open issues, recent PRs, CI health)Create and manage pull requests automatically via AI workflowsSchedule recurring maintenance tasks on GitHub repositoriesIntegrate multiple AI models for decision-making in CI/CDPrototype agentic automation for open source projects
FAQ
What is GitHub Agentic Workflows?
GitHub Agentic Workflows (gh-aw) is an open-source CLI extension that lets you define automated workflows using natural language markdown and run them in GitHub Actions with AI support.
How do I install gh-aw?
Run the install script from a terminal: curl -sL https://raw.githubusercontent.com/github/gh-aw/main/install-gh-aw.sh | bash. No GitHub token is required.
Which AI models are supported?
The tool supports GitHub Copilot, Anthropic Claude, OpenAI Codex, and Google Gemini. You need to set the corresponding API keys as repository secrets for the AI provider you choose.
How do I start using it in my repository?
After installing, run 'gh aw init' in your repository to configure it, then use 'gh aw add' to add a workflow. For example, 'gh aw add --create-pull-request' adds a daily repo status workflow.
Is gh-aw free?
Yes, the tool is open source and free. Usage may consume GitHub Actions minutes, which have free tiers for public repositories and limited free minutes for private repositories.
What are guardrails?
Guardrails are built-in safety and security measures to ensure that AI-generated actions remain within safe boundaries. GitHub states that guardrails are foundational to the project.