Connect GitHub to let Supernaut monitor your repositories and act on issues, pull requests, and comments.

Connect GitHub

1. Go to Integrations
2. Click Connect next to GitHub
3. Verify your email if needed
4. Choose which repositories — or your entire organization — to grant access to
5. Click Install

You'll be returned to Supernaut with GitHub connected. A loading indicator appears next to each repository during setup — it turns green once onboarding is complete.

Supernaut only acts in repositories you explicitly grant access to.

Using Supernaut in GitHub

• Mention in a comment — Simply type Supernaut's name in any issue or PR comment. Use it to ask questions, request code changes, or give follow-up instructions. Supernaut reads the full thread before responding.

Once Supernaut is active on an issue or PR, just reply naturally — no need to mention it again. It follows the conversation automatically.

Add repositories

1. Go to Integrations → GitHub
2. Click the + icon — you'll be taken to the GitHub App settings page
3. Select the repositories you want to add
4. Click Save on GitHub

Changes take effect immediately.

Disconnect

Remove a single repository:

1. Click the × next to the repository under the GitHub integration card
2. You'll be taken to the GitHub App settings page
3. Uninstall the repository you want and click Save

Access is revoked and all indexed data for that repository is removed.

Disconnect GitHub entirely:

1. Go to Integrations → GitHub
2. Click the trash icon
3. Confirm — this uninstalls the GitHub App and removes all connected repositories at once

Link GitLab so Supernaut can track your repositories and respond to issues, merge requests, and comments.

Connect GitLab

1. Go to Integrations
2. Click Connect next to GitLab
3. You'll be redirected to GitLab to authorize via OAuth
4. Once authorized, a repository picker appears — select the GitLab projects you want Supernaut to be active in
5. Click Confirm

Supernaut installs webhooks on each selected project automatically. You'll see a loading indicator next to each repository — it turns green once setup is complete.

Supernaut only acts in repositories you explicitly select.

Using Supernaut in GitLab

Once GitLab is connected, there are two ways to trigger Supernaut:

• Assign to an issue or merge request — Add Supernaut as an assignee on any issue or MR in a connected repository.
• Mention in a comment — @mention Supernaut on any issue or MR comment to loop it into the conversation.

Add repositories

You can add more repositories at any time.

1. Go to Integrations → GitLab
2. Click the + icon
3. Select the projects you want to add
4. Click Confirm to apply

Disconnect

Remove a single repository — Click the × next to any repository under the GitLab integration card. The webhook is removed immediately.

Disconnect GitLab entirely:

1. Go to Integrations → GitLab
2. Click the trash icon
3. Confirm — this removes all connected repositories at once

Supernaut integrates with Sentry so you can route errors directly to it for investigation and resolution. Once connected, it can pick up Sentry issues and fix them — just like it handles bug tickets from Linear or Jira.

Connect Sentry

1. Go to Integrations
2. Find Sentry in the list and click Connect
3. Authorize Supernaut with your Sentry account and click Install
4. Once connected, Supernaut has access to your Sentry projects and can start working on errors you assign to it

Using Supernaut with Sentry

Supernaut doesn't automatically act on every Sentry error — you decide what it works on. There are two ways to trigger it:

• Via Slack — If Sentry is connected with Slack and Supernaut is invited to the channel receiving alerts, it automatically picks up incoming errors and starts working on them.
• Via other integrations — Paste a Sentry issue ID into any connected integration and mention or assign Supernaut.

Once triggered, Supernaut reads the error context, locates the relevant code, investigates the root cause, implements a fix, and opens a merge or pull request for review.

Disconnect Sentry

1. Go to Integrations → Sentry
2. Click the trash icon
3. Confirm the disconnection

Supernaut will no longer receive or process Sentry events. Note that disconnection may take up to 15 minutes to fully take effect.

Connect Linear to let Supernaut track and act on issues across your teams.

Connect Linear

1. Go to Integrations
2. Click Connect on the Linear card
3. Log in to Linear if needed
4. Check the selected workspace in the top left — switch to the desired one if necessary
5. Select specific teams or all teams Supernaut can access
6. Approve permissions and confirm

You'll be redirected back to the dashboard with the integration saved.

Each Linear organization can only connect to one Supernaut workspace. Connecting an already-connected organization will return a conflict error.

Using Supernaut in Linear

• Assign Supernaut to an issue — Supernaut activates and starts working immediately. Unassigning it stops any active workflow for that issue.
• Mention Supernaut in a comment — Type @supernaut or just mention supernaut in any issue comment.

Once engaged via assignment or mention, any new comment on the issue continues the conversation automatically — no need to re-mention each time.

Disconnect Linear

1. Go to Integrations → Linear
2. Click the trash icon
3. Confirm — Supernaut revokes access and removes all integration data

Connect Jira so Supernaut can act on issues and collaborate with your team directly through comments.

Connect Jira

1. Go to Integrations
2. Click Install on the Jira card — you'll be redirected to the Jira Marketplace
3. Click Get App
4. Select the workspace you want to install Supernaut in
5. Click Install
6. After installation, go to your workspace
7. Click the settings icon in the top right and select Marketplace Apps
8. Click Take me there to open the new app management page
9. Search for Supernaut in the apps list
10. Click the three dots menu → Configure
11. Click Connect in the Configure Supernaut Integration panel
12. A popup will confirm you're opening an external page — click Continue and you'll be redirected to the dashboard with Jira successfully connected

Alternatively, after installation you can navigate to admin.atlassian.com → Apps → Sites, select your site, then Connected Apps — you'll end up in the same apps list to continue from step 9.

One Jira Cloud site maps to one Supernaut workspace. Connecting an already-connected site will return a conflict error.

Using Supernaut in Jira

• Mention Supernaut in a comment — Type @Supernaut in any Jira issue comment. Supernaut picks it up and starts working.

Once engaged, any follow-up comment on the same issue continues the conversation automatically — no need to re-mention each time.

Disconnect Jira

1. Go to Integrations → Jira
2. Click the trash icon
3. Confirm — Supernaut revokes access and removes all integration data

Connect Slack so your team can interact with Supernaut directly in conversations — ask questions, trigger tasks, and discuss your codebase without leaving Slack.

Connect Slack

1. Go to Integrations
2. Click Connect on the Slack card
3. Select your workspace
4. Approve permissions

You'll be redirected back with the integration saved.

One Slack workspace maps to one Supernaut workspace. Connecting an already-connected workspace will return a conflict error.

Important: Supernaut must be manually invited to each channel — /invite @Supernaut. Slack doesn't auto-add bots for privacy reasons.

Using Supernaut in Slack

• @Mention — Type @Supernaut in any channel or group it's been invited to. Supernaut responds in-thread.
• Keyword — Any message containing "supernaut" triggers a response — no formal @mention needed.
• Direct message — DM Supernaut directly. To start a conversation, click the three dots menu next to Direct Messages in your Slack sidebar, select Create, and search for Supernaut in the "To" field. No @mention required — all DMs are processed automatically.
• Ongoing thread — Once engaged, any follow-up in that thread continues the conversation automatically.

How Supernaut responds

When triggered, Supernaut posts a notification in-thread and updates it in place as it progresses, so your team can follow along in real time.

Disconnect Slack

1. Go to Integrations → Slack
2. Click the trash icon
3. Confirm the disconnection

Connect Microsoft Teams so your team can interact with Supernaut directly in chats, group conversations, and channels.

Connect Teams

1. Go to Integrations → Teams
2. Click Connect
3. Sign in with your Microsoft account
4. You'll see a Permissions requested screen from Microsoft — checking "Consent on behalf of your organization" is optional but recommended, so other users won't be prompted for permissions later
5. Click Accept
6. You'll see a success message on the dashboard with an Open in Teams button

Important: You must be a Teams Admin or Global Admin in your Microsoft 365 organization to connect. If you're not an admin, ask your admin to complete this step.

Install the Supernaut App in Teams

1. Click the Open in Teams button on the Supernaut dashboard
2. Teams will open and show the Supernaut app page
3. Click Add to install it
4. You can select channels or teams you want Supernaut in and click Go — or add it to them later

If you closed the install page, you can find Supernaut anytime:

1. Click the Apps icon in the bottom-left of Teams
2. Search for Supernaut
3. Look for it under Built for your org
4. Click Add

Important: If you see "Something went wrong" when clicking Add, wait a minute and try again — it can take a moment for the app to become available after connecting.

Adding & Using Supernaut in Teams

1:1 Chat

Find Supernaut in your recent chats, or start a new chat and search for Supernaut. Type your message and send — Supernaut responds in the same chat. No @mention needed.

Group Chat

1. Open the group chat
2. Click the people icon at the top → Add agents and bots
3. Search for Supernaut and add it

Type @supernaut followed by your message to start a conversation.

Important: You need to mention Supernaut with every message for it to respond.

Team Channel

1. Go to the team → click the three dots menu next to the team name → Manage team → Apps tab → Get more apps
2. Search for Supernaut under Built for your org
3. Click Open and select the channel you want — Supernaut will be added to that team's other channels too

Alternatively, you can go straight to the Apps icon in the bottom-left of Teams and continue from step 2.

Start a new post or reply to an existing thread with @supernaut followed by your message — Supernaut responds in the same thread.

Important: You need to mention Supernaut with every message for it to respond.

Remove Supernaut

From a group chat:

1. Open the group chat
2. Click the people icon at the top
3. Click × next to Supernaut
4. Confirm removal

From a team:

1. Go to the team → click three dots menu next to the team name → Manage team
2. Go to the Apps tab
3. Find Supernaut → click the three dots menu → Remove
4. Confirm — Supernaut is removed from all channels in that team

Uninstall

1. Go to Integrations → Teams
2. Click the trash icon
3. Supernaut will stop responding to messages but still be visible in Teams — users will need to uninstall the app individually by clicking the three dots menu in the Teams sidebar, right-clicking Supernaut, and selecting Uninstall

For Teams Admins: To fully remove the app from your organization's catalog, go to Teams Admin Center → Manage Apps → Actions → Delete.