Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Repository Management

Odin Scan integrates with GitHub to manage the repositories available for analysis. This page covers how to add, sync, and manage repositories from the dashboard.

Adding Repositories

Odin Scan accesses your repositories through GitHub. To make repositories available for scanning:

  1. Navigate to Repositories from the sidebar.
  2. Click Sync Repositories.
  3. Odin Scan fetches your accessible GitHub repositories and adds them to the dashboard.

Note: You must have a GitHub token configured. Go to Settings and connect your GitHub account or provide a personal access token with repository read access.

Repository List View

The Repositories page displays all synced repositories in a list with the following information:

ColumnDescription
NameRepository name and owner (e.g., username/my-contracts)
LanguagePrimary programming language detected by GitHub
Default BranchThe repository’s default branch (e.g., main)
Last SyncedWhen the repository metadata was last updated

Click on any repository to view its details and scan history.

Repository Details

The detail view for a repository shows:

  • Repository metadata – name, URL, default branch, and language.
  • Scan history – a chronological list of all analyses run on this repository, with status and summary for each.
  • Quick actions – start a new analysis directly from the repository detail page.

Syncing Repositories

Odin Scan provides two sync modes:

Full Sync

POST /api/v1/repositories/sync

A full sync fetches all accessible repositories from GitHub and updates the local database. Use this when:

  • You have added new repositories to your GitHub account.
  • You want to ensure the dashboard reflects your complete repository list.
  • Repository metadata (name, default branch) has changed.

Quick Sync

POST /api/v1/repositories/quick-sync

A quick sync performs an incremental update, fetching only repositories that have changed since the last sync. This is faster than a full sync and is suitable for regular use.

Note: Repository sync is rate-limited to 10 requests per hour across all subscription tiers. See Rate Limits for details.

Repository Statistics

The Stats view provides aggregate data across all synced repositories:

  • Total number of repositories synced.
  • Number of repositories that have been scanned.
  • Breakdown of scan results across repositories.

Access stats via the Repositories page or the API (GET /api/v1/repositories/stats).

Troubleshooting

Repositories not appearing after sync:

  • Verify your GitHub token has the required permissions (repo scope for private repositories, or public_repo for public only).
  • Check that the repository is accessible with your GitHub account.
  • Try a full sync instead of a quick sync.

Stale repository data:

  • Repository metadata (name, branches) is updated during sync. Run a new sync to refresh.

Next Steps