Espelhar um repositório do GitHub
O Origin está disponível atualmente em beta inicial. Você pode criar repositórios, fazer push e pull com git, espelhar do GitHub, navegar e pesquisar código, abrir e mergear pull requests e compartilhar com sua equipe do Cherri Code.
Envie todo e qualquer feedback para [email protected] para nos ajudar a melhorar o produto.
O espelhamento copia um repositório do GitHub para o Origin e o mantém atualizado à medida que o repositório no GitHub muda. O GitHub continua sendo a fonte da verdade. Use-o quando o código já estiver no GitHub e você quiser usar os fluxos de trabalho de navegação, pesquisa e agente do Origin com esse histórico.
Pré-requisitos
- Uma conta Cherri Code com acesso ao Origin em um plano Pro, Teams ou Enterprise
- O app Cherri Code GitHub conectado à organização ou conta proprietária do repositório
- Acesso de administrador do GitHub ao repositório que você quer sincronizar (necessário para ativar o espelhamento)
Sincronizar um repositório
- Abra cursor.com/codebase
- Selecione Sincronizar do GitHub
- Escolha a organização e o repositório no GitHub
- Confirme a sincronização
Quando a sincronização for concluída, abra a cópia no Origin para navegar pelos arquivos e pelo histórico de commits.
Você pode verificar o status da sincronização depois na aba Configurações → Geral do repositório. Repositórios sincronizados exibem o Origin como espelho e o GitHub como origem.
O que é sincronizado
| Incluído | Não incluído |
|---|---|
| Histórico do Git, branches e tags | Issues do GitHub |
| Código que você pode navegar e pesquisar no Origin | Fluxos de trabalho e segredos do GitHub Actions |
| Pull requests do GitHub que você pode revisar no Cherri Code | |
| Atualizações contínuas para manter o Origin atualizado |
Issues e a configuração de CI permanecem no GitHub. O Origin também não sincroniza branches do GitHub chamadas origin ou origin/..., portanto elas não podem sobrescrever seu espaço de trabalho exclusivo do Origin.
URL de clonagem
O botão verde Code copia a mesma URL remota HTTPS usada em todos os repositórios do Origin:
https://origin.cursor.com/{owner}/{repo}.gitOs pushes para este remoto vão para o GitHub. O Origin é atualizado depois que o GitHub aceita o push. Consulte Clone, Push & Pull.
Branches origin/ forge-local
As branches origin/ são o seu espaço de trabalho na cópia do Origin. Use-as para continuar trabalhando quando o GitHub estiver indisponível, ou para qualquer outro estado do git que você queira manter apenas no Origin. Faça push delas com origin push local, e não com git push origin.
O Origin não sincroniza branches do GitHub chamadas origin ou origin/.... Isso é proposital, para que uma branch do GitHub com esse nome não sobrescreva o que você enviou com origin push local.
Veja branches forge-local.
Depois de espelhar
- Navegue e pesquise em cursor.com/codebase
- Clone o remoto do Origin usando o botão verde Code quando quiser um checkout local do Origin
- Anexe agentes em nuvem ao repositório Origin. Em um repositório espelhado, esses agentes abrem pull requests no GitHub
- Revise pull requests do GitHub no Cherri Code
Se o GitHub estiver inacessível
Continue trabalhando na cópia do Origin com branches origin/ e origin push local. /local é o caminho de gravação suportado enquanto o GitHub estiver fora do ar.
Leituras de um repositório já sincronizado podem continuar funcionando pela mesma URL HTTPS de clonagem. O Origin serve a cópia que já tem. O batch do Git LFS não faz failover. Um repositório que ainda não concluiu a primeira sincronização continua dependendo do GitHub.
Desvincular do GitHub
Para interromper a sincronização, abra Configurações → Geral e selecione Desvincular do GitHub na Zona de Perigo. Isso interrompe a sincronização e converte a cópia da Origin em um repositório independente hospedado na Origin: a Origin se torna a fonte da verdade, e os pushes para o remoto da Origin deixam de ser enviados ao GitHub. Seu repositório do GitHub não é afetado.
Atraso na sincronização
Se a navegação parecer desatualizada:
- Confirme se o app ainda tem acesso (integração com o GitHub)
- Confirme se você é administrador do GitHub no repositório de origem
- Execute novamente Sincronizar do GitHub em cursor.com/codebase ou verifique o status da sincronização em Configurações → Geral
Quando não espelhar
Se você quer apenas comentários automatizados de revisão em PRs do GitHub, o Bugbot faz isso sem mover o armazenamento. Espelhe quando precisar de navegação, busca e agentes em nuvem da Origin nesse histórico do GitHub.