Using GitHub with SoterAI

What SoterAI can access

Once connected, SoterAI has read-only access to:

• Repositories your GitHub account has access to (public and private)
• Repository content: files, code, and directory structure
• Issues: title, description, comments, labels, and status
• Pull requests: title, description, diffs, review comments, and status
• Repository metadata: name, description, branches, contributors

Read-only access: SoterAI can read and search your GitHub repositories and issues, but cannot create, edit, merge, or delete any content.

What SoterAI cannot do

• Cannot create, edit, merge, or close pull requests or issues
• Cannot push code or create commits
• Cannot manage repository settings, permissions, or webhooks
• Cannot access repositories your account does not have permission to view

How to connect GitHub

1. In the SoterAI chat bar, click the puzzle piece icon
2. In the Connectors panel, find GitHub and click Connect
3. An authorisation link will appear — click it
4. Sign in to your GitHub account in the browser window that opens
5. Grant SoterAI read access when prompted
6. Return to SoterAI — GitHub now shows as Connected

Your connection is persistent — you won't need to reconnect each session. If your connection expires, SoterAI will prompt you to reconnect.

What you can ask SoterAI

Once connected, just ask naturally in any chat or workflow:

Finding content

• “Find any open GitHub issues related to safety feature development”
• “Search the repository for documentation about the safety data pipeline”
• “What pull requests are currently open in the safety module?”

Reading and summarising

• “Summarise the open issues in the safety-module repository”
• “What does the README say about the safety data integration?”
• “What changes were made in the last merged pull request?”

Using in workflows

• “Pull the open issues from GitHub and help me prioritise them by safety impact”
• “Read the technical specification in the GitHub repo and summarise the safety data requirements”

Use cases

Technical safety feature tracking

For organisations with safety technology teams, ask SoterAI to retrieve the status of safety-related development tickets and pull requests from GitHub, giving non-technical stakeholders a plain-language status update.

Documentation access

When technical safety documentation (integration guides, API specs, data schemas) is stored in GitHub repositories, ask SoterAI to retrieve and explain it without requiring repository access or technical knowledge.

Cross-tool reporting

Combine the GitHub connector with Records Management — ask SoterAI to pull the details of a technical issue from GitHub and use them to create an incident or action record in SoterAI.

Troubleshooting

My GitHub connection expired

Ask SoterAI “Reconnect to GitHub” and follow the authorisation link it provides.

SoterAI can't find a repository I know exists

Confirm your GitHub account has access to that repository. For private repositories, check that the OAuth authorisation included access to private repos. Try specifying the repository name directly: “Search the [repo-name] GitHub repository for [topic]”.

SoterAI can access the repository but can't read a specific file

Some file formats (binary files, large files) may not be readable. Try asking SoterAI to list the files in the directory first, then request the specific file by name.