> ## Documentation Index
> Fetch the complete documentation index at: https://cf826a1-spikonado.manicule.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://cf826a1-spikonado.manicule.dev/docs/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://cf826a1-spikonado.manicule.dev/docs/api/mcp.
> Every agent surface: https://cf826a1-spikonado.manicule.dev/docs/.well-known/llms-manifest.json

# GitHub (/docs/use/github)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 637 · updated: 2026-11-21 -->
Related: [Projects and threads](/docs/use/projects-and-threads.md), [Models and providers](/docs/use/models-and-providers.md), [What the agent can do](/docs/use/agent-tools.md), [Instructions and skills](/docs/use/instructions-and-skills.md), [Hardware](/docs/use/hardware.md), [Purchases](/docs/use/purchases.md)

> Connect GitHub so Sprocket's agent can link pull requests to threads, watch their checks and reviews, and settle threads when they merge.

The agent uses the [GitHub CLI](https://cli.github.com) for pull requests and other GitHub work. Sprocket installs it for you.

## Sign in

In **Settings → Connectors**, click **Sign in** next to `github.com`. Sprocket shows a code and a link to GitHub. Open the link on any device, enter the code, and approve the sign-in. The GitHub card then shows **Signed in as** and your GitHub username. **Sign out** removes the login from the computer running Sprocket.

For GitHub Enterprise, click **Add a GitHub Enterprise host**, enter its hostname, and sign in the same way.

If `GH_TOKEN` or `GITHUB_TOKEN` is set where Sprocket runs, Sprocket uses that token instead. For an Enterprise host, set `GH_HOST` to its hostname and `GH_ENTERPRISE_TOKEN` or `GITHUB_ENTERPRISE_TOKEN` to its token.

Sprocket no longer saves GitHub tokens. If you saved one in **Settings → Version Control**, sign in again from **Settings → Connectors**.

## Pull requests in threads

The agent links the pull requests it works on to the thread. They appear in the thread's **Pull requests** list with their current status. The agent can wait on a pull request until its checks finish or a reviewer comments.

To settle a thread when its pull requests merge, turn on **Settle threads when their PRs merge** in [Settings → General](/docs/reference/settings#general).

## Commits

Sprocket tells the agent to add Sprocket as a co-author on its commits. Turn this off in [Settings → Version Control](/docs/reference/settings#version-control).

## Pull the latest code

<Note>This is only in dev and canary builds. It isn't in a stable release yet. See [release
channels](/docs/install#release-channels).</Note>

Turn on **Pull the latest code automatically** in [Settings → Version Control](/docs/reference/settings#version-control) to keep your projects up to date. Every 5 minutes, each computer running Sprocket runs `git pull --ff-only` in the checkout of each of its projects that has an `origin` remote.

A pull only fast-forwards the current branch to its upstream. Git refuses it when the branch has no upstream, has commits that aren't upstream, or has uncommitted changes that the pull would overwrite. Agents already running in a checkout see its files change when a pull lands.

## Turn off GitHub

Turn off GitHub, or one of its hosts, in **Settings → Connectors**. The agent then can't link pull requests, and their status stops refreshing.
