Docs/Plataforma e integrações/GitHub

O agente dentro
do seu repositório.

Mencione o agente num comentário de issue ou PR e ele trabalha dentro do runner do GitHub Actions: triagem, correção em branch nova, PR aberto — sem sair do fluxo do time.

Disponível agoraHow-to /github1 min de leitura

01Instalando

terminal · na raiz do repo

mvcode github install

O comando guia a instalação do app, cria o workflow e configura os secrets. O essencial do workflow gerado:

.github/workflows/opencode.ymlyml

on:
  issue_comment: { types: [created] }
  pull_request_review_comment: { types: [created] }

jobs:
  agent:
    if: contains(github.event.comment.body, '/oc')
    runs-on: ubuntu-latest
    permissions: { id-token: write }
    steps:
      - uses: actions/checkout@v6
        with: { persist-credentials: false }
      - uses: anomalyco/opencode/github@latest
        env: { ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} }
        with: { model: anthropic/claude-sonnet-4-5 }

Guarde as chaves de provedor em Settings → Secrets and variables → Actions.

02Usando

Você comenta…	O agente…
/oc explain this issue	Lê a thread inteira e responde com a explicação.
/oc fix this	Cria branch, implementa e abre PR com as mudanças.
Delete o anexo do S3 ao remover a nota /oc	Implementa e commita no próprio PR.
[nas linhas do diff] /oc add error handling	Recebe arquivo, linhas e contexto do diff — resposta cirúrgica.

03Eventos suportados

Evento	Disparo	Nota
issue_comment	Comentário em issue ou PR	Menção no corpo do comentário.
pull_request_review_comment	Comentário em linhas do diff	Contexto de arquivo e linha incluído.
issues	Issue aberta ou editada	Requer `prompt` — triagem automática.
pull_request	PR aberto ou atualizado	Sem `prompt`, o default é revisar o PR.
schedule	Cron	Requer `prompt` + permissões de escrita para criar branches/PRs.
workflow_dispatch	Manual, pela aba Actions	Requer `prompt`.

04Configuração da action

modelprovider/modelobrigatório

O modelo que o agente usa no runner.

agentstringdefault_agent · build

Agente primário a usar.

sharebooleantrue em repo público

Compartilha a sessão do run — link no comentário de resposta.

promptstring

Sobrepõe o comportamento padrão — critérios de review, foco, formato de resposta.

tokenstringtoken do app

Por padrão, commits e PRs saem como o app instalado. Alternativas: o GITHUB_TOKEN nativo do runner (conceda contents/pull-requests/issues: write) ou um PAT.

05Review automático de PRs

.github/workflows/review.ymlyml

on:
  pull_request: { types: [opened, synchronize, reopened] }
# … checkout + action com:
with:
  model: anthropic/claude-sonnet-4-5
  use_github_token: true
  prompt: |
    Revise este pull request:
    - qualidade e bugs em potencial
    - sugestões de melhoria

Para triagem de issues com filtro anti-spam (idade da conta), rode um step github-script antes e condicione o job ao resultado.

Compatibilidade · identificadores da integração

A integração usa a infraestrutura herdada do núcleo: o GitHub App opencode-agent, a action anomalyco/opencode/github, o nome de workflow opencode.yml e as menções /opencode e /oc. São identificadores de compatibilidade — o produto que roda no runner é o MVCode, com a sua config e o seu AGENTS.md.