Skip to main content
The GitHub integration syncs issues and pull requests from your selected repositories into Mains’s entity store. Once synced, GitHub data is searchable locally and available as context in AI chat conversations.

​
Authentication

GitHub uses OAuth for authentication. When you connect GitHub, Mains will open a browser window to authorize access. The resulting token is stored encrypted in the local database.
Mains requests read access to issues and pull requests. Write actions (updating issues, adding comments) go through the outbox system for offline-first reliability.

​
Setup

1

Connect GitHub

Go to Settings > Connections and click Connect next to GitHub. A browser window will open for OAuth authorization.
2

Select Repositories

After authorization, choose which repositories to sync. Only issues and pull requests from selected repositories will be fetched.
3

Initial Sync

Mains will perform an initial sync to fetch existing issues and pull requests.