> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aurora-ai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Interage com o GitHub ou ativa fluxos de trabalho a partir de eventos do GitHub

export const BlockInfoCard = ({type, color, icon = false, iconSvg}) => {
  return <div className="mb-6 overflow-hidden rounded-lg border border-border">
      <div className="flex items-center justify-center p-6">
        <div className="flex h-20 w-20 items-center justify-center rounded-lg" style={{
    backgroundColor: color
  }}>
          {iconSvg ? <div className="h-10 w-10 text-white" dangerouslySetInnerHTML={{
    __html: iconSvg
  }} /> : <div className="font-mono text-xl opacity-70">
              {type.substring(0, 2)}
            </div>}
        </div>
      </div>
      {icon && <style jsx global>{`
          .block-icon {
            width: 80px;
            height: 80px;
            margin: 1rem auto;
            display: block;
          }
        `}</style>}
    </div>;
};

<BlockInfoCard
  type="github"
  color="#181C1E"
  icon={true}
  iconSvg={`<svg className="block-icon"    viewBox='0 0 26 26' xmlns='http://www.w3.org/2000/svg'>
  <path
    d='M13 0C11.2928 0 9.60235 0.336255 8.02511 0.989566C6.44788 1.64288 5.01477 2.60045 3.80761 3.80761C1.36964 6.24558 0 9.55219 0 13C0 18.746 3.731 23.621 8.892 25.35C9.542 25.454 9.75 25.051 9.75 24.7V22.503C6.149 23.283 5.382 20.761 5.382 20.761C4.784 19.253 3.939 18.85 3.939 18.85C2.756 18.044 4.03 18.07 4.03 18.07C5.33 18.161 6.019 19.409 6.019 19.409C7.15 21.385 9.061 20.8 9.802 20.488C9.919 19.643 10.257 19.071 10.621 18.746C7.735 18.421 4.706 17.303 4.706 12.35C4.706 10.907 5.2 9.75 6.045 8.827C5.915 8.502 5.46 7.15 6.175 5.395C6.175 5.395 7.267 5.044 9.75 6.721C10.777 6.435 11.895 6.292 13 6.292C14.105 6.292 15.223 6.435 16.25 6.721C18.733 5.044 19.825 5.395 19.825 5.395C20.54 7.15 20.085 8.502 19.955 8.827C20.8 9.75 21.294 10.907 21.294 12.35C21.294 17.316 18.252 18.408 15.353 18.733C15.821 19.136 16.25 19.929 16.25 21.138V24.7C16.25 25.051 16.458 25.467 17.121 25.35C22.282 23.608 26 18.746 26 13C26 11.2928 25.6637 9.60235 25.0104 8.02511C24.3571 6.44788 23.3995 5.01477 22.1924 3.80761C20.9852 2.60045 19.5521 1.64288 17.9749 0.989566C16.3977 0.336255 14.7072 0 13 0Z'
    fill='currentColor'
  />
</svg>`}
/>

[GitHub](https://github.com/) é a plataforma líder mundial para desenvolvimento de software e controle de versão usando Git. Fornece um ambiente colaborativo onde desenvolvedores podem hospedar e revisar código, gerenciar projetos e construir software juntos.

Com o GitHub, você pode:

* **Hospedar repositórios**: Armazene seu código em repositórios públicos ou privados com controle de versão
* **Colaborar no código**: Use pull requests para propor mudanças, revisar código e mesclar contribuições
* **Rastreamento de problemas**: Crie, atribua e gerencie issues para organizar o trabalho e rastrear bugs
* **Automatizar fluxos de trabalho**: Use GitHub Actions para construir, testar e fazer deploy de código automaticamente
* **Gerenciar projetos**: Organize o trabalho com quadros de projetos, marcos e rastreamento de tarefas
* **Documentar código**: Crie e mantenha documentação com GitHub Pages e wikis

No Sim, a integração com o GitHub permite que seus agentes interajam diretamente com repositórios e fluxos de trabalho do GitHub. Isso possibilita cenários de automação poderosos como assistência em revisão de código, gerenciamento de pull requests, rastreamento de problemas e exploração de repositórios. Seus agentes podem obter dados do repositório, analisar mudanças no código, publicar comentários em pull requests e realizar outras operações do GitHub de forma programática. Esta integração fecha a lacuna entre seus fluxos de trabalho de IA e seus processos de desenvolvimento, permitindo colaboração fluida entre seus agentes e sua equipe de desenvolvimento.

## Instruções de uso

Integre o GitHub no fluxo de trabalho. Pode obter detalhes de PR, criar comentários em PR, obter informações do repositório e obter o último commit. Requer uma chave API de token do GitHub. Pode ser usado no modo de ativação para iniciar um fluxo de trabalho quando um PR é criado, comentado ou quando um commit é enviado.

## Ferramentas

### `github_pr`

Obter detalhes de PR incluindo diferenças e arquivos modificados

#### Entrada

| Parâmetro    | Tipo   | Obrigatório | Descrição                   |
| ------------ | ------ | ----------- | --------------------------- |
| `owner`      | string | Sim         | Proprietário do repositório |
| `repo`       | string | Sim         | Nome do repositório         |
| `pullNumber` | number | Sim         | Número do pull request      |
| `apiKey`     | string | Sim         | Token de API do GitHub      |

#### Saída

| Parâmetro  | Tipo   | Descrição                                                 |
| ---------- | ------ | --------------------------------------------------------- |
| `content`  | string | Resumo de PR legível por humanos                          |
| `metadata` | object | Metadados detalhados de PR incluindo mudanças em arquivos |

### `github_comment`

Criar comentários em PRs do GitHub

#### Entrada

| Parâmetro     | Tipo   | Obrigatório | Descrição                                         |
| ------------- | ------ | ----------- | ------------------------------------------------- |
| `owner`       | string | Sim         | Proprietário do repositório                       |
| `repo`        | string | Sim         | Nome do repositório                               |
| `body`        | string | Sim         | Conteúdo do comentário                            |
| `pullNumber`  | number | Sim         | Número do pull request                            |
| `path`        | string | Não         | Caminho do arquivo para o comentário de revisão   |
| `position`    | number | Não         | Número da linha para o comentário de revisão      |
| `commentType` | string | Não         | Tipo de comentário (pr\_comment ou file\_comment) |
| `line`        | number | Não         | Número da linha para o comentário de revisão      |
| `side`        | string | Não         | Lado do diff (LEFT ou RIGHT)                      |
| `commitId`    | string | Não         | O SHA do commit sobre o qual comentar             |
| `apiKey`      | string | Sim         | Token de API do GitHub                            |

#### Saída

| Parâmetro  | Tipo   | Descrição                                     |
| ---------- | ------ | --------------------------------------------- |
| `content`  | string | Confirmação de comentário legível por humanos |
| `metadata` | object | Metadados do comentário                       |

### `github_repo_info`

Recupera metadados completos do repositório do GitHub, incluindo estrelas, forks, problemas e linguagem principal. Compatível com repositórios públicos e privados com autenticação opcional.

#### Entrada

| Parâmetro | Tipo   | Obrigatório | Descrição                                            |
| --------- | ------ | ----------- | ---------------------------------------------------- |
| `owner`   | string | Sim         | Proprietário do repositório (usuário ou organização) |
| `repo`    | string | Sim         | Nome do repositório                                  |
| `apiKey`  | string | Sim         | Token de acesso pessoal do GitHub                    |

#### Saída

| Parâmetro  | Tipo   | Descrição                                 |
| ---------- | ------ | ----------------------------------------- |
| `content`  | string | Resumo do repositório legível por humanos |
| `metadata` | object | Metadados do repositório                  |

### `github_latest_commit`

Recupera o último commit de um repositório do GitHub

#### Entrada

| Parâmetro | Tipo   | Obrigatório | Descrição                                                   |
| --------- | ------ | ----------- | ----------------------------------------------------------- |
| `owner`   | string | Sim         | Proprietário do repositório (usuário ou organização)        |
| `repo`    | string | Sim         | Nome do repositório                                         |
| `branch`  | string | Não         | Nome do branch (por padrão, o branch padrão do repositório) |
| `apiKey`  | string | Sim         | Token de API do GitHub                                      |

#### Saída

| Parâmetro  | Tipo   | Descrição                            |
| ---------- | ------ | ------------------------------------ |
| `content`  | string | Resumo do commit legível por humanos |
| `metadata` | object | Metadados do commit                  |

## Notas

* Categoria: `tools`
* Tipo: `github`