O que issue-flow faz?
Transforme uma issue em um Pull Request revisado, sem precisar ficar monitorando. Uma CLI (com Skills de Agente) que executa todo o pipeline — planejar, implementar, verificar, revisar, entregar — de forma autônoma no Claude Code, Codex CLI, Cursor CLI ou Antigravity CLI.
Visão Geral
O issue-flow automatiza o processo de pegar uma issue do GitHub, planejar uma solução, implementar as alterações de código, verificar a qualidade, revisar o código e, finalmente, criar um Pull Request revisado. Tudo isso sem intervenção manual contínua.
Funcionalidades
- Pipeline completo: planejar, implementar, verificar, revisar, entregar.
- Suporte a múltiplos agentes: Claude Code, Codex CLI, Cursor CLI, Antigravity CLI.
- Execução headless: funciona em segundo plano ou em CI/CD.
- Modo contínuo (watch): monitora issues e processa automaticamente.
- Resumo detalhado: ao final da execução, gera um resumo do que foi feito.
Instalação
npm install -g issue-flow
Uso
# Executa o pipeline completo para uma issue específica
issue-flow run --issue 42
# Executa em modo contínuo, processando novas issues
issue-flow watch
# Exibe ajuda
issue-flow --help
Configuração
Crie um arquivo .issue-flow.json no diretório raiz do projeto:
{
"agent": "claude-code",
"steps": ["plan", "implement", "verify", "review", "deliver"],
"github": {
"token": "${GITHUB_TOKEN}",
"owner": "meu-usuario",
"repo": "meu-repositorio"
}
}
Variáveis de Ambiente
ISSUE_FLOW_GITHUB_TOKEN: Token de acesso pessoal do GitHub.ISSUE_FLOW_AGENT: Agente a ser usado (padrão:claude-code).ISSUE_FLOW_VERIFY_COMMAND: Comando personalizado para verificação.
Licença
MIT