BuildShip Docs
Testar gratis

Integracao GitHub

Conecte sua conta GitHub ao BuildShip pra salvar o codigo dos seus projetos na nuvem automaticamente. O time de IA pode clonar repositorios existentes, criar branches, fazer commits e abrir pull requests.

Jeito facil: use o botao "Conectar com GitHub" (OAuth) — 1 clique, sem colar token.

Por que conectar

  • Backup automatico do codigo que o time cria
  • Historico completo de alteracoes (cada mudanca vira um commit)
  • Colaborar com desenvolvedores humanos que ja usam GitHub
  • Fazer deploy via Git em servicos como Vercel, Netlify, Railway
  • Clonar projetos existentes seus pra continuar trabalhando no BuildShip

Como conectar (recomendado: OAuth)

  1. Acesse Ajustes no seu dashboard do BuildShip
  2. Va na aba Integracoes
  3. Clique no botao escuro "Conectar com GitHub"
  4. Voce e redirecionado pro GitHub — faca login se precisar
  5. Clique em "Authorize BuildShip" pra autorizar o app
  6. Pronto. Voce volta pro BuildShip ja conectado.
O que o BuildShip pode ver? O OAuth pede permissao repo (ler/escrever seus repositorios, publicos e privados) e read:user (seu username e email). Nada mais. Voce pode revogar a qualquer momento em github.com/settings/applications.

Conectar pelo chat do projeto

Dentro de qualquer projeto, clique no icone de integracoes na barra lateral do chat, clique em GitHub e, se ja estiver conectado no nivel da conta, voce vera o botao verde "Usar conta conectada (@seu-usuario)". Clique nele pra ativar a integracao naquele projeto sem precisar reautorizar.

Como desconectar

  1. Em Ajustes, aba Integracoes, clique em "Desconectar" no card do GitHub
  2. O token e apagado do BuildShip imediatamente
  3. Voce tambem pode revogar o acesso em github.com/settings/applications

Jeito manual (alternativa: Personal Access Token)

Se por alguma razao voce nao quer usar OAuth, da pra colar um Personal Access Token (PAT) do GitHub.

  1. Acesse github.com/settings/tokens/new
  2. Note que o scope repo ja vem marcado no link acima
  3. De um nome: "BuildShip"
  4. Expiracao: 90 dias ou "No expiration"
  5. Clique Generate token e copie o valor
  6. No BuildShip, va em Ajustes > Integracoes > GitHub
  7. Cole no campo "Token de acesso" e clique Conectar GitHub

Problemas comuns

Lista de repositorios vazia

Se voce tem repositorios em uma organizacao (nao na conta pessoal), verifique se o OAuth app tem acesso a essa org. Va em github.com/settings/applications, clique em "BuildShip" e habilite o acesso a organizacao desejada.

Erro "Token invalido ou expirado"

Se usou o metodo manual (PAT), o token pode ter expirado. Crie um novo em github.com/settings/tokens e cole de novo. Ou simplesmente clique em "Reconectar com GitHub" pra usar OAuth (tokens OAuth nao expiram tao facilmente).

Nao consigo clonar um repositorio privado

Certifique-se de que o token (PAT ou OAuth) tem o scope repo, nao apenas public_repo. O OAuth do BuildShip ja pede repo por padrao.