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

# Repositórios

> Clone qualquer repositório git para seu espaço - faça push, pull e gerencie branches.

Você pode clonar qualquer repositório git para o [Drive](/about/drive) do seu espaço. Após clonado, a IA pode ler, editar e fazer commit no repositório assim como funciona com apps.

## Clonando um repositório

Peça à IA para clonar um repositório, ou use o botão **+** da barra lateral do Drive e escolha **Clonar repositório**. Forneça a URL do git e o Kazzle cuida do resto.

## Autenticação

As credenciais do Git são gerenciadas através do [vault](/work/vault). O Kazzle suporta:

* **GitHub App** - tokens de instalação, auto-atualização. A abordagem recomendada.
* **Chaves SSH** - armazenadas no vault, injetadas via credential helper.
* **Tokens de acesso pessoal** - armazenados no vault, usados para clonagem HTTPS.

A máquina em nuvem busca credenciais do servidor sob demanda, que as resolve a partir do vault. Nenhuma credencial é armazenada em disco na máquina.

## Operações

| Operação           | Quem pode fazer | Notas                                                                     |
| ------------------ | --------------- | ------------------------------------------------------------------------- |
| Clonar             | Você ou IA      | Adiciona o repositório ao Drive                                           |
| Pull               | Você ou IA      | Busca e mescla alterações remotas                                         |
| Commit             | Você ou IA      | Faz commit de alterações locais                                           |
| Push               | Você ou IA      | Terminal `git push` solicita aprovação por padrão; force push é bloqueado |
| Criar pull request | Você ou IA      | A IA pode abrir PRs a menos que você restrinja                            |
| Branch/switch      | Você ou IA      | Criar ou alternar branches                                                |

Você pode exigir aprovação para qualquer uma dessas operações - ou bloqueá-las - em [políticas de ferramentas](/security/tool-policies).

## Estado do Git no Drive

O Drive mostra o estado do git automaticamente: branch atual, commits recentes, alterações não commitadas e o quão à frente/atrás do remoto. Isso é atualizado em tempo real conforme a IA trabalha.