---
title: "Sync GitHub stars, repositories, and gists to Keep | Keep"
description: "Connect GitHub to save new starred repositories and gists with README content, metadata, and clone instructions."
canonical: "https://keep.md/docs/github"
language: "en"
---

# Sync GitHub stars

Connect GitHub to save new starred repositories and gists with README content, metadata, and clone instructions.

Personal lets you save a public repository or gist. It also connects GitHub and syncs new Stars and Gists in the background.

Keep includes the repository description, README, metadata, and clone URL when available.

## Connect GitHub

1.  Open **Settings**.
2.  Open **Connections**.
3.  Find **GitHub**.
4.  Select **Connect GitHub**.
5.  Authorise access to your stars.
6.  Choose a recent backfill or start from now.
7.  Choose whether to sync starred gists.

Keep starts an initial sync when you select a backfill.

## Choose a backfill

Use **Start from now** to save only future stars. Use a recent-star option to import up to the current limit shown in Keep.

The backfill runs once. Later syncs save only new stars.

## Sync starred gists

Turn on starred-gist sync to save gists with their files, metadata, and clone URL. You can change this setting after you connect.

## Sync now

Open the GitHub connection. Select **Sync now** to check for new stars. Keep shows the current run status and any error.

## Save a repository directly

Personal lets you save a public repository without connecting GitHub. Use Capture, the browser extension, CLI, API, or MCP.

```
https://github.com/iannuttall/seo
```

Keep saves the available README, repository metadata, default branch, clone URL, and instructions that can help an agent inspect the repository.

You can also save a public gist URL.

## Use a repository with a Project

A saved GitHub item is source material. A Project repository URL identifies the codebase for note search and CLI context.

Add repository URLs to a [Project](https://keep.md/docs/projects). Link the saved repository item to a [note](https://keep.md/docs/notes) when it is evidence for a decision or handoff.

## Disconnect GitHub

Open the GitHub connection and select **Disconnect**. Existing items stay in Keep, but future stars stop syncing.