> Documentation index: https://rift.sh/llms.txt

[Use Rift with your agent](https://rift.sh/docs/use-with.md)

# Use Rift with GitHub

Git holds the source and its history. Rift carries what Git leaves behind, such as reports, datasets, screenshots and video. Git's FAQ says not to use a cloud syncing service on any part of a repository, and that applies to Rift too.

## Set it up

Keep the repository where it is, outside `~/rift`. Have the agent write the files Git does not track to a Rift folder. Syncing a repository can corrupt it, as [Git's FAQ](https://git-scm.com/docs/gitfaq), read in October 2026, says.

## What you get

Everything a run produces outside the repository is on every machine you use.

## How they differ

The comparison says what each one does, who can read your files and when to choose which.

[Rift vs GitHub](https://rift.sh/compare/rift-vs-github.md)