LimitationsGitHub synchronization is limited to issues, discussions, and top-level pull request comments.
In-code comments in pull requests, the actual source code, and other GitHub-specific data, such as commit history, are not synchronized unless you enable it. Files larger than 4MiB are ignored.
In-code comments in pull requests, the actual source code, and other GitHub-specific data, such as commit history, are not synchronized unless you enable it. Files larger than 4MiB are ignored.
Overview
Dust integrates with Github to bring your repository’s Issues, Pull Requests, Discussions, and (if enabled) codebase into Dust, so agents can search and use that content. Only Github Admins can set up this connection due to permission restrictions.Setting up the Connection
Initial Connection Setup
- Access Control: Ensure you’re a Dust Admin and have the necessary permissions on GitHub to establish connections.
- Navigate to Dust: Go to
Spaces>Connections> SelectGitHub> Connect. - Authenticate: Click
Configureand authenticate your GitHub account to grant Dust permission to access your GitHub data.
- Select your repos: Give access to the repo you select from
Repository access.
- Enable Code sync: Optionally give access to your codebase by toggling
Code synchronization.
PermissionsEnsure the GitHub account used for the connection has ongoing access to the selected repositories. Changing permissions in GitHub may impact Dust’s ability to synchronize new data.
The Github app will be created with the following permissions
Repository content : ReadOnly
Issues : ReadOnly
Discussions : ReadOnly
Pages : ReadOnly
Projects : ReadOnly
Pull Requests : ReadOnly
All the rest : No Access
Issues : ReadOnly
Discussions : ReadOnly
Pages : ReadOnly
Projects : ReadOnly
Pull Requests : ReadOnly
All the rest : No Access
Updating the Connection and Managing Permissions
To modify permissions and which repositories or types of data are synchronized:- Go to
Spaces>Connections. - Click
Managenext to GitHub. - Click Add/Remove Data, Manage permissions, re-auth, and follow the steps above.
- Adjust your selections for repositories, then save your changes.
Data Synchronization
- Issues: Titles, descriptions, comments, and tags.
- Discussions: Discussion titles, initial posts, and comments.
- Pull Requests: Titles, descriptions, and top-level comments (in-code comments not included).
- Code Synchronization: Repository code from the default branch
Refresh and Sync Details
- Issues, Discussions, and Pull Requests: Dust syncs these in response to GitHub webhook events. There is no fixed refresh interval.
- Code: For routine updates, a merged pull request triggers a sync of that repository’s default branch. Dust does not start another sync for that repository if a code sync was triggered in the previous 8 hours. A merge during those 8 hours does not trigger a later sync. Another merged pull request after the 8-hour period can trigger the next sync. Direct pushes do not trigger a code sync.
title:Title of the issue/pull request,
isPullRequest:true|false,
author:@githubHandle.
Labels allow for additional filtering on data sources selected on the semantic search tool.
Labels support was added Feb 11 2025Issues and Pull Requests older than that won’t have those labels ingested.