Integrations

GitHub Integration

Connect GitHub to sync selected repositories into your ContextStream workspace. Issues, pull requests, releases, and comments become searchable memory events.

Per-Workspace Integration

The GitHub integration is configured per workspace. Each ContextStream workspace can connect to different GitHub organizations or repositories. This allows teams to keep their contexts separate while sharing the same ContextStream organization.

What You Get

Once connected, your GitHub data enriches AI interactions across ContextStream. Here's how it adds value:

Automatic Context Enrichment

When you call context_smart or session_smart_search, relevant GitHub issues, PRs, and decisions are automatically included in AI responses. No extra tools needed — your existing prompts become smarter.

Example: Ask "What did we decide about authentication?" and get decisions extracted from issue discussions without calling any GitHub-specific tool.

Extracted Knowledge

ContextStream automatically distills decisions, lessons, and insights from your GitHub conversations. These become searchable memory that persists across sessions.

Example: Use integration(provider="github", action="knowledge") to see "We decided to use JWT for auth" extracted from PR #42 discussion.

Cross-Repository Search

Search across all your synced repositories by meaning, not just keywords.

Example: Search for "rate limiting" and find related issues across multiple repos.

Unified Memory

GitHub events become memory events alongside your manual captures. Use memory(action="search", ...) or session(action="recall", ...) to find GitHub context mixed with your other decisions and notes.

Example: "What do we know about the payment system?" returns your captured decisions AND relevant GitHub issue discussions.

Example Prompts

Try these prompts in your AI editor to see GitHub integration in action:

>"What open issues do we have about performance?"

>"Show me recent PRs related to authentication"

>"What decisions were made in issue #123?"

>"Who are the top contributors this month?"

>"What lessons did we learn from the API refactor?"

>"Search GitHub for 'memory leak' from the last 7 days"

>"Summarize GitHub activity for the past 2 weeks"

Overview

The GitHub integration brings your repository activity into ContextStream, making issues, pull requests, releases, and comments searchable and available as context for your AI tools. Content is synced as memory events that can be retrieved via MCP tools or the search API.

Real-Time Webhooks

Issues, PRs, and comments are captured via webhooks as they're created or updated.

Semantic Search

Find issues and PRs by meaning, not just keywords. Search across all synced repositories instantly.

Analytics Dashboard

Track repository activity, top contributors, and engagement trends at a glance.

Setup Guide

1. Connect Your GitHub Account

1Go to your ContextStream workspace settings and navigate to Integrations.
2Click Connect on the GitHub card to start the OAuth flow.
3Authorize ContextStream to access your GitHub repositories. You can grant access to all repos or select specific ones.
4Once connected, the GitHub card will show "Connected" status.

2. Select Repositories to Sync

1Click Configure on the connected GitHub integration.
2Browse available repositories from your GitHub account or organization.
3Select the repositories you want to sync. Both public and private repos are supported.
4Optionally, link repositories to specific ContextStream projects for organized context retrieval.

3. Initial Sync & Backfill

After selecting repositories, ContextStream will perform an initial sync to import issues, PRs, and releases. You can configure the backfill depth in the integration settings.

Click Sync Now at any time to trigger an immediate sync of all configured repositories.

What Gets Synced

Content Type	Details	Metadata Captured
Issues	All issues from configured repositories	Title, body, author, labels, state, assignees
Pull Requests	PRs with full description and state	Title, body, author, reviewers, status, labels
Releases	Published releases and their notes	Tag name, release notes, author, date
Comments	Issue and PR comments	Content, author, parent issue/PR reference

MCP Tools (v0.4.x)

Access GitHub data through the consolidated integration tool available in Claude Code, Cursor, Windsurf, and other MCP-compatible editors.

Use integration(provider="github", action="...") for GitHub-specific queries.

integration(provider="github", action="stats")

Get overview statistics: total issues, PRs, releases, comments, repo stats, and sync status.

integration(provider="github", action="repos")

List synced repositories with issue counts, PR counts, and last activity timestamps.

integration(provider="github", action="search", query="...")

Search GitHub issues, PRs, and comments by content. Filter by repo, type, state, and timeframe (days param). Sort by relevance, recent, or engagement.

integration(provider="github", action="issues")

Get issues and PRs with filtering by state (open/closed) and repository.

integration(provider="github", action="contributors")

Get top contributors by activity count with usernames and avatars.

integration(provider="github", action="activity")

Get recent activity feed, optionally filtered by repository, type (issue, PR, release, comment), and timeframe (days param).

integration(provider="github", action="knowledge")

Get decisions, lessons, and insights automatically extracted from GitHub issues and PRs. Filter by knowledge type (decision, lesson, fact, insight).

integration(provider="github", action="summary")

Get a high-level summary of GitHub activity with trends, key decisions, and notable changes. Customize timeframe with the days param and optionally scope by repo.

integration(provider="all", action="search", query="...")Cross-Source

Search across GitHub and Slack in a single query. Results ranked by relevance across sources. Sort by relevance, recent, or engagement.

integration(provider="all", action="summary")Cross-Source

Get a unified summary across GitHub and Slack with combined activity stats, highlights, and key topics. Great for understanding overall team activity.

integration(provider="all", action="knowledge")Cross-Source

Get decisions, lessons, facts, and insights from all connected integrations in a single query. Filter by knowledge type (decision, lesson, fact, insight) and optionally search by query.

GitHub Dashboard

Access detailed analytics and insights from the GitHub Dashboard in your workspace settings.

Overview Stats

Total issues, PRs, releases, comments, and repositories synced at a glance.

Activity Chart

Visualize issues, PRs, and comment activity over time to spot trends.

Top Contributors

See who's most active with contribution counts and GitHub profiles.

Repository Stats

Per-repository breakdown of issues, PRs, releases, and comments.

Security & Privacy

OAuth 2.0 Authentication

ContextStream uses GitHub's official OAuth flow. Your credentials are never stored — only encrypted access tokens.

Minimal Scopes

We request only read-only scopes needed for syncing: repo (for private repos), read:user. No write access is requested.

Explicit Repository Selection

You choose exactly which repositories to sync. No repositories are synced by default.

Revoke Anytime

Disconnect the integration at any time from your workspace settings. This revokes access and stops all syncing.

Sync Behavior

Real-Time Webhooks

New issues, PRs, releases, and comments are captured via GitHub webhooks as they're created. This provides near-instant sync for new content.

Periodic Polling

A background sync runs periodically to catch any missed events and update issue/PR states.

Manual Sync

Click Sync Now in the integration settings to trigger an immediate full sync of all configured repositories.

State Updates

When issues or PRs are closed or merged, the state is updated in ContextStream automatically.

Troubleshooting

Integration shows "Error" status

This usually means the OAuth token has expired or been revoked. Try disconnecting and reconnecting the integration. If the issue persists, check that you haven't revoked the GitHub app authorization in your GitHub settings.

Private repositories not showing

Make sure you granted access to private repositories during the OAuth flow. You can update repository access from your GitHub Settings → Applications → Authorized OAuth Apps.

Search not finding recent issues/PRs

New content may take a few minutes to be indexed and searchable. Try clicking Sync Nowto force an immediate sync, then search again.

Organization repositories not available

For organization repositories, you may need organization admin approval for OAuth apps. Contact your GitHub organization admin to approve ContextStream access.

Next Steps

Once connected, GitHub issues, PRs, releases, and comments become Memory Events (source: github) and are available to your AI tools via MCP.

Back to integrations overview or see Slack integration.

GitHub is a trademark of GitHub, Inc. ContextStream is not affiliated with, endorsed by, or sponsored by GitHub, Inc.