> ## 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.

# Repos

> Clone any git repo into your space - push, pull, and manage branches.

You can clone any git repository into your space's [Drive](/about/drive). Once cloned, the AI can read, edit, and commit to the repo just like it works with apps.

## Cloning a repo

Tell the AI to clone a repo, or use the Drive sidebar's **+** button and choose **Clone repo**. Provide the git URL and Kazzle handles the rest.

## Authentication

Git credentials are managed through the [vault](/work/vault). Kazzle supports:

* **GitHub App** - installation tokens, auto-refresh. The recommended approach.
* **SSH keys** - stored in the vault, injected via credential helper.
* **Personal access tokens** - stored in the vault, used for HTTPS cloning.

The cloud machine fetches credentials from the server on demand, which resolves them from the vault. No credentials are stored on disk on the machine.

## Operations

| Operation           | Who can do it | Notes                                                                   |
| ------------------- | ------------- | ----------------------------------------------------------------------- |
| Clone               | You or AI     | Adds the repo to Drive                                                  |
| Pull                | You or AI     | Fetches and merges remote changes                                       |
| Commit              | You or AI     | Commits local changes                                                   |
| Push                | You or AI     | Terminal `git push` asks for approval by default; force push is blocked |
| Create pull request | You or AI     | The AI can open PRs unless you restrict it                              |
| Branch/switch       | You or AI     | Create or switch branches                                               |

You can require approval for any of these - or block them - in [tool policies](/security/tool-policies).

## Git state in Drive

Drive shows git state automatically: current branch, recent commits, uncommitted changes, and how far ahead/behind remote. This updates in real time as the AI works.