GitHub integration

What engineering context becomes retrievable

Retrieve repository, issue, pull-request, and commit context from repositories you grant access to.

Choose repository scope

Guided first connection checklist

• A GitHub account with access to the repositories you intend to share.
• Permission to grant repository access under your organization’s policy.
• A MemorySync project for the imported engineering knowledge.

Initial and incremental ingestion

1. 1
   Grant repository access

   Authorize only the repositories needed for the use case.

2. 2
   Import engineering context

   Supported content enters the ingestion workflow.

3. 3
   Apply incremental changes

   Later ingestion processes changed supported content incrementally.

4. 4
   Retrieve

   Query the imported knowledge with other project memories.

Verify with a real engineering question

Query for a known issue, pull request, or commit from a repository in the granted set. Confirm the result belongs to the intended project and repository boundary before expanding access.

Common repository issues

Related docs and sources

Operations on this page

Authentication and scope

1. Check GitHub availability

Read the provider record before showing a connect button. It reports whether GitHub is available and the object and sync capabilities enabled by this deployment.

import os
from memorysync import MemorySyncClient

client = MemorySyncClient(
    api_key=os.environ["MEMORYSYNC_API_KEY"],
    base_url="https://api.memorysync.io",
)

provider = client.providers.get("github")
print(provider["is_available"], provider["capabilities"])

2. Authorize GitHub

Start OAuth on your server, then redirect the browser to authorization_url. Keep connection_id so you can verify the result after consent.

import os
from memorysync import MemorySyncClient

client = MemorySyncClient(
    api_key=os.environ["MEMORYSYNC_API_KEY"],
    base_url="https://api.memorysync.io",
)

result = client.connections.oauth.initiate(
    "github",
    redirect_url="https://app.example.com/connections/callback",
)
print(result["authorization_url"], result["connection_id"])

3. Confirm and sync

Confirm status is connected before queuing the first incremental sync.

import os
from memorysync import MemorySyncClient

client = MemorySyncClient(
    api_key=os.environ["MEMORYSYNC_API_KEY"],
    base_url="https://api.memorysync.io",
)

connection = client.connections.get("conn_8f21a4")
if connection["status"] == "connected":
    job = client.connections.trigger_sync("conn_8f21a4", job_type="incremental")
    print(job["id"], job["status"])

Errors and next action