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

# Code context

> Use the Scott GitHub App to make repository context available to Sync Chat and planspaces.

Code context is supporting setup for the Scott GitHub App. It lets Scott answer and review with awareness of your actual repositories instead of only the text in an agent session or planspace.

Use code context when:

* Sync Chat needs to explain a pattern across recent code work
* a planspace needs architecture-aware recommendations
* reviewers need to verify a proposal against the current repo
* a pulled planspace should give an agent context that matches the codebase

## Connect GitHub

1. Click **Connect repo** from Sync Chat or the planspace composer
2. Install the Scott GitHub App for the GitHub account or organization you want Scott to read from
3. We recommend granting access to all repositories; limiting access can cap answer quality when relevant context lives outside one repo

<Info>
  Scott is SOC 2 compliant. We do not persist repository contents. We fetch code only into ephemeral sandboxes when an answer needs it, and if you remove GitHub access Scott can no longer fetch that code.
</Info>

After installation, the repositories you granted access to appear in Scott's repo picker.

## Select repositories and branches

When you attach a repository, Scott records the repository and branch selection for that Sync Chat turn or planspace. Use the branch that best represents the code your proposal depends on.

For example:

* use `main` for product or architecture context
* use a feature branch when a prototype already exists
* use a migration branch when reviewing rollout or compatibility risk

## Uploaded files

You can also upload files directly, such as PDFs, design specs, architecture docs, or code snippets.

1. Click **Add source** or the source picker
2. Choose **Files**
3. Drag and drop or browse for files

## Access changes

If a repository does not appear, reopen **Connect repo** and update repository access on the Scott GitHub App installation.

If access is removed in GitHub, Scott can no longer fetch that repository. Existing planspace documents and comments remain, but future code-aware answers cannot use removed code.

## Code context vs PR design review

Code context helps Scott answer questions, write better plans, and run stronger PR reviews. [PR design review](/developer-tools/scott-ci) is the primary GitHub App workflow that links implementation work back to planspaces after a pull request is opened or updated.
