Skip to content
TeamLoop

GitHub Integration

Connect GitHub to search issues, pull requests, discussions, and commits across your repositories.

What You Can Query

Section titled “What You Can Query”
Content TypeDescription
IssuesBug reports, feature requests, tasks
Pull RequestsCode reviews, changes, discussions
DiscussionsQ&A, announcements, ideas
CommitsCode changes with messages
CommentsConversation threads

Connecting GitHub

Section titled “Connecting GitHub”
  1. Log into TeamLoop at app.teamloop.io
  2. Navigate to Settings > Integrations
  3. Click Connect next to GitHub
  4. Enter your GitHub Personal Access Token (PAT)
  5. TeamLoop validates the token and saves it encrypted

Creating a GitHub PAT

Section titled “Creating a GitHub PAT”
  1. Go to github.com/settings/tokens
  2. Click Generate new token (classic)
  3. Select these scopes:
    • repo — Full access to repositories (issues, PRs, code)
    • read:org — Read organization membership (for org-scoped searches)
  4. Copy the token and paste it into TeamLoop

Your PAT determines what TeamLoop can access. You’ll only see repos and issues that your token has permission to read. We never write to your repositories.

Example Queries

Section titled “Example Queries”

Search Issues

Section titled “Search Issues”
teamloop_query:
  query: "authentication bug"
  sources: "github"

Find Architecture Decisions

Section titled “Find Architecture Decisions”
teamloop_query:
  query: "ADR architecture decision record"
  sources: "github"

Search PRs by Topic

Section titled “Search PRs by Topic”
teamloop_query:
  query: "database migration"
  sources: "github"

Automatic Change Tracking

Section titled “Automatic Change Tracking”

TeamLoop automatically tracks changes from GitHub:

Issue Timeline

Section titled “Issue Timeline”

When you query an issue, TeamLoop fetches its changelog:

  • Status changes (open → closed)
  • Label changes
  • Assignee changes
  • Milestone changes

PR Events

Section titled “PR Events”

Pull request lifecycle events:

  • Review requests
  • Approvals
  • Merges
  • Status checks

Entity Extraction

Section titled “Entity Extraction”

GitHub content maps to TeamLoop entity types:

GitHubTeamLoop Entity
IssueDOCUMENT
PRDOCUMENT
DiscussionDOCUMENT
CommitCHANGE
Comment authorPERSON
Status changeCHANGE

Temporal Queries with GitHub

Section titled “Temporal Queries with GitHub”

Point-in-Time

Section titled “Point-in-Time”

See what was known from GitHub on a specific date:

teamloop_query:
  query: "authentication"
  sources: "github"
  mode: "as_of"
  as_of: "2024-01-15"

Evolution

Section titled “Evolution”

Track how GitHub discussions evolved:

teamloop_evolution:
  query: "authentication github"
  from_date: "2024-01-01"
  to_date: "2024-12-31"

Troubleshooting

Section titled “Troubleshooting”

No Results

Section titled “No Results”
  • Check that the integration is connected
  • Verify you have access to the repositories
  • Try a broader search term
  • Check if the content is in private repos you authorized

Missing Repos

Section titled “Missing Repos”
  • Ensure your PAT has the repo scope
  • For organization repos, ensure your PAT has read:org scope
  • Check that your GitHub account has access to the repos

Security

Section titled “Security”
  • API tokens are encrypted at rest using pgcrypto
  • Tokens can be revoked from GitHub settings
  • TeamLoop only reads, never writes
  • You can disconnect at any time from TeamLoop settings
  • Connected tokens show a hint (e.g., ghp_...a3f) so you can identify which token is in use

Next Steps

Section titled “Next Steps”