Skip to main content
Connecting GitHub activates two of CauseFlow’s specialized agents:
  • Code Analyzer — reads source files, searches the codebase, and reviews recent commits to identify code-level root causes.
  • Code Fixer — creates draft pull requests with proposed fixes when the Code Analyzer identifies a bug as the root cause.
Together, these agents allow CauseFlow to move from “here is the root cause” to “here is the fix, ready for your review.”

​
What CauseFlow accesses

PermissionAccess levelUsed for
ContentsReadReading source files and searching the codebase
Pull requestsWriteCreating draft pull request proposals
Commit historyReadIdentifying recent changes that may have caused the incident
Repository metadataReadMapping services to repositories
CauseFlow never reads secrets, environment variables, or files outside the repositories you explicitly select.

​
Installation

1

Open the GitHub integration

Go to Dashboard > Integrations > GitHub and click Install GitHub App.
2

Authorize on GitHub

You’ll be redirected to GitHub. Sign in if prompted, then select whether to install the app on your personal account or an organization.
3

Select repositories

Choose Only select repositories and pick the repositories you want CauseFlow to analyze. You can always add more repositories later from GitHub’s app settings.
Selecting All repositories works too, but we recommend starting with a specific list so you stay in control of what CauseFlow can access.
4

Approve permissions

GitHub will show the permissions the CauseFlow app requires:
  • Contents: Read
  • Pull requests: Write
Click Install to approve and complete the installation.
5

Return to CauseFlow

You’ll be redirected back to the CauseFlow dashboard. The GitHub integration will show a green connected status and list the repositories you selected.

​
How code fixes work

The Code Fixer agent only activates when the Code Analyzer has identified a bug in the source code as the root cause. It will not create pull requests for infrastructure issues, database problems, or configuration changes. When it does create a pull request:
  • The PR is always a draft — it will not auto-merge
  • The PR description includes the root cause analysis that motivated the change
  • Your team reviews and merges it like any other PR, using your normal approval process
CauseFlow only creates draft pull requests. Your team reviews and merges them like any other PR.

​
Managing the installation

View connected repositories: Go to Dashboard > Integrations > GitHub. You’ll see the list of connected repositories and when each was last used by an agent. Add or remove repositories: Click Manage on GitHub to update the repository selection directly in GitHub’s app settings. Changes take effect immediately. Revoke access: To fully disconnect, either:
  • Click Disconnect in Dashboard > Integrations > GitHub to remove the integration from CauseFlow, or
  • Go to GitHub > Settings > Applications > Installed GitHub Apps, find CauseFlow, and click Configure > Uninstall.
Both methods immediately revoke access. Any in-progress investigations that rely on the Code Analyzer will complete with partial results.