Skip to main content

Connecting GitHub

Step-by-step guide to connecting your GitHub account to DreamSolve.

Prerequisites​

  • A GitHub account
  • Access to the repositories you want to connect
  • Admin permissions if connecting organization repositories

Connection Steps​

Step 1: Open Settings​

  1. Click Settings in the DreamSolve menu bar
  2. Navigate to the Integrations section

Step 2: Initiate Connection​

  1. Find the GitHub section
  2. Click Connect GitHub
  3. A new window opens for GitHub authorization

Step 3: Authorize the App​

  1. Review the permissions requested
  2. Click Authorize DreamSolve
  3. Select which repositories to grant access to:
    • All repositories (current and future)
    • Only selected repositories

Step 4: Complete Setup​

  1. Return to DreamSolve
  2. Verify the connection shows as active
  3. Test by browsing available repositories

What Gets Connected​

When you connect GitHub, DreamSolve can:

FeatureDescription
View RepositoriesSee repo names and descriptions
Read CodeAgents can analyze your code
Read IssuesImport issues as DreamSolve nodes
Read PRsView pull request status

Using GitHub Features​

Importing Issues​

  1. Create a new Project node
  2. Click Import from GitHub
  3. Select repository and issues
  4. Issues become task nodes

Linking Repositories​

  1. Select a Project node
  2. Open Settings/Properties
  3. Choose linked repository
  4. Code context becomes available

Agent Code Access​

Once linked, agents can:

  • Read and understand your codebase
  • Reference specific files
  • Suggest changes based on actual code

Security Notes​

  • DreamSolve uses OAuth for secure authentication
  • Your GitHub password is never stored
  • You can revoke access anytime from GitHub settings
  • Repository access follows your GitHub permissions

Troubleshooting​

Authorization Failed​

  1. Clear browser cookies
  2. Log out of GitHub
  3. Try the connection again
  4. Ensure you have necessary permissions

Repositories Not Showing​

  1. Check you granted access to the specific repos
  2. For org repos, ensure the org has approved the app
  3. Try disconnecting and reconnecting

Organization Repositories​

If you need org repos:

  1. An org admin must approve the DreamSolve app
  2. Go to org Settings → Third-party access
  3. Approve the DreamSolve GitHub App

Disconnecting​

To remove GitHub access:

  1. Go to Settings in DreamSolve
  2. Find GitHub integration
  3. Click Disconnect

Additionally, revoke from GitHub:

  1. Go to GitHub Settings
  2. Applications → Authorized OAuth Apps
  3. Find DreamSolve and revoke