Skip to main content
O tool @forge traz o seu Git forge para dentro do loop do agente. Ele roda operações de pull request, issue e CI através da CLI que você já autenticou — gh para GitHub, glab para GitLab — para que o agente feche o ciclo diário branch → PR → observar CI → corrigir sem você trocar de janela.
O @forge é keyless por design. O ChatCLI nunca guarda um token de forge: ele delega para o binário gh/glab no qual o usuário fez login (gh auth login / glab auth login). O que essas CLIs conseguem fazer com a sua conta, o @forge consegue — nada mais, nada menos.
O uso típico é depurar um PR vermelho: @forge pr-checks 42 mostra quais checks falharam, @forge ci-logs <run-id> puxa apenas os logs dos steps que falharam, o agente corrige o código, e @forge pr-comment 42 --body "…" reporta de volta.

​
Pré-requisitos

O @forge precisa da CLI oficial do forge instalada e autenticada na sua máquina:
1

Instale a CLI

GitHub: instale o gh. GitLab: instale o glab. Qualquer uma basta — o @forge escolhe a certa automaticamente (veja abaixo).
2

Autentique uma vez

O ChatCLI reaproveita essa sessão. Não há nada para configurar dentro do ChatCLI e nenhum token para colar.
3

Rode dentro de um repositório

O @forge lê o remote origin para decidir GitHub vs GitLab, então rode o agente a partir de um repo clonado (ou passe host explicitamente).

​
Uso

Tanto o envelope JSON {cmd, args} quanto a forma argv plana são aceitos, e a grafia em dois tokens dobra no comando canônico — pr view 42 é o mesmo que pr-view 42.

​
Subcomandos

​
GitHub ou GitLab — decidido por você

O @forge escolhe o backend automaticamente:
1

Host explícito vence

Passe {"host":"github"} ou {"host":"gitlab"} para forçar gh ou glab naquela chamada.
2

Senão, o remote git decide

Um remote origin apontando para uma URL do GitLab roteia para glab; qualquer outra coisa cai no default gh (GitHub).
A superfície de comandos é idêntica nos dois — o @forge mapeia o vocabulário do GitLab para você: um PR vira um merge request (pr-* → mr), um comentário vira uma note, e --base vira --target-branch. Você escreve um único conjunto de comandos; a CLI certa roda por baixo.

​
Exemplo prático: corrigindo um PR vermelho sem sair do agente

O mesmo fluxo funciona em merge requests do GitLab sem mudança — só a CLI por baixo difere.

​
Segurança

  • Leituras são auto-aprovadas. pr-list, pr-view, pr-diff, pr-checks, issue-list, issue-view, ci-status, ci-logs e detect só observam o estado do forge, então rodam sem prompt de confirmação e podem ser paralelizadas.
  • Mutações passam pelo security gate. pr-create, pr-comment e issue-comment mudam o que outras pessoas veem, então passam pela mesma política de confirmação de qualquer outra tool call com efeito colateral — você (ou sua política) aprova cada uma.
  • Nada é escalado silenciosamente: argumentos imparseáveis falham fechados (tratados como não read-only), e o tool nunca inventa um token — ele só faz o que o seu gh/glab logado consegue.
A saída do @forge tem limite para impedir que diffs grandes de PR e logs de CI inundem o contexto. Para um diff completo, o agente pode recorrer ao @coder git-diff numa branch com checkout.

​
Próximos Passos

Plugins Agênticos

O catálogo completo de tools builtin e como o agente as usa.

Segurança do Coder Mode

Como o security gate arbitra tool calls que mutam estado.