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

# Repositories

> Manage code repositories and run security scans

The Repositories page shows all repositories in your project. Add repositories, run scans, and view security issues for each repository.

## Repository List

View all repositories with:

* **Repository name** - Name from GitHub or custom label
* **Last scan** - When the repository was last scanned
* **Issues** - Open issue count
* **Status** - Scan status (Idle, Scanning, etc.)

## Adding Repositories

### Via GitHub Integration (Recommended)

1. Go to **Settings** → **Integrations**
2. Click **"Connect GitHub"** if not connected
3. Return to **Repositories** → **"Add Repository"**
4. Select repositories from the dropdown

### Manual Setup

For repositories not in GitHub:

1. Click **"Add Repository"**
2. Select **"Manual Setup"**
3. Follow CLI instructions to upload your code

## Running Scans

### Manual Scan

1. Find the repository in the list
2. Click **"Scan"**
3. Monitor progress in the scan indicator

### Automatic Scans

Enable auto-scanning for repositories:

1. Click the repository settings (gear icon)
2. Toggle **"Auto Scan"** on
3. Scans trigger on:
   * New pull requests
   * Pushes to the default branch

See [Auto Scan](/github/auto-scan) for configuration options.

## Repository Detail View

Click a repository to see:

* **Issues tab** - Security findings for this repository only
* **Scans tab** - History of all scans
* **Settings** - Repository-specific configuration

### Filtering Issues

Within a repository view:

* Filter by **branch** to see branch-specific issues
* Filter by **severity** to prioritize critical findings
* Filter by **status** to see open, ignored, or closed issues

## Repository Settings

Configure per-repository options:

| Setting            | Description                          |
| ------------------ | ------------------------------------ |
| **Default Branch** | Branch to scan for baseline issues   |
| **Auto Scan**      | Enable automatic scanning on PR/push |
| **Ignored Paths**  | File patterns to exclude from scans  |

## Deleting Repositories

1. Click repository settings (gear icon)
2. Scroll to **"Danger Zone"**
3. Click **"Delete Repository"**

<Warning>
  Deleting a repository removes all associated issues and scan history.
</Warning>

## Related Pages

<CardGroup cols={2}>
  <Card title="Issues" icon="bug" href="/dashboard/issues">
    View all issues across repositories
  </Card>

  <Card title="Auto Scan" icon="rotate" href="/github/auto-scan">
    Configure automatic scanning
  </Card>

  <Card title="GitHub Setup" icon="github" href="/github/setup">
    Connect GitHub for easier setup
  </Card>

  <Card title="CLI Scanning" icon="terminal" href="/cli/scanning">
    Scan via command line
  </Card>
</CardGroup>