github/gh-aw

O que é?

Recursos principais

• 01Define workflows em Markdown com YAML frontmatter para configurar gatilhos, permissões, ferramentas e o mecanismo escolhido.
• 02Compila cada workflow em um workflow padrão do GitHub Actions usando gh aw compile.
• 03Oferece suporte aos mecanismos GitHub Copilot, Claude Code, OpenAI Codex, Google Gemini e Pi.
• 04Por padrão, executa os jobs dos agentes em modo somente leitura e em sandbox.
• 05Aplica alterações no GitHub por meio de jobs safe-outputs validados e com permissões restritas.

Casos de uso

• Fazer a triagem de issues novas e adicionar rótulos automaticamente.
• Revisar pull requests com um agente de IA como parte do CI.
• Investigar execuções de CI com falha e resumir a causa.
• Manter a documentação atualizada e gerar relatórios periódicos do repositório.

Início rápido

1. 1

   Instale a extensão do GitHub CLI

   gh extension install github/gh-aw
2. 2

   Siga o guia de início rápido para escolher um mecanismo de IA, adicionar um fluxo de trabalho de exemplo e executá-lo pelo GitHub Actions

Antes de usar

• !É necessária uma conta ou chave de API de um mecanismo de IA, como GitHub Copilot, Claude Code, OpenAI Codex ou Google Gemini.
• !Fluxos de trabalho agênticos exigem supervisão humana cuidadosa, e o README recomenda usá-los por sua própria conta e risco.
• !As versões a partir da 0.83.3 e anteriores à 0.85.4 foram descontinuadas após a descoberta de uma vulnerabilidade de segurança.

Tópicos

Perguntas frequentes

O que é gh-aw?

Extensão do GitHub CLI que permite criar automações de repositório com IA em Markdown e executá-las com segurança pelo GitHub Actions. O GitHub Agentic Workflows (gh-aw) permite definir tarefas para agentes de IA em um repositório usando arquivos Markdown com YAML frontmatter. O comando gh aw compile transforma cada workflow em um arquivo padrão do GitHub Actions, executado no GitHub.

gh-aw é gratuito? Qual é a licença?

gh-aw é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

gh-aw ainda é mantido?

Manutenção ativa. O último commit de gh-aw foi em 20 de out. de 2026.

Para que posso usar gh-aw?

Fazer a triagem de issues novas e adicionar rótulos automaticamente. Revisar pull requests com um agente de IA como parte do CI. Investigar execuções de CI com falha e resumir a causa. Manter a documentação atualizada e gerar relatórios periódicos do repositório.

Como instalar gh-aw?

Instale a extensão do GitHub CLI: gh extension install github/gh-aw Siga o guia de início rápido para escolher um mecanismo de IA, adicionar um fluxo de trabalho de exemplo e executá-lo pelo GitHub Actions

Onde consigo gh-aw?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/github/gh-aw