OctopusOctopus/Docs/Integrations
Get Started
Integrations

Integrations

Connect Octopus with your existing tools for automated code reviews and seamless team workflows.

GitHub

Install the Octopus GitHub App to enable automatic PR reviews, check runs, and inline code comments.

Setup

  1. Install the Octopus GitHub App from the settings page
  2. Select which repositories to monitor
  3. PRs are reviewed automatically on open and update

Automatic PR Reviews

Every new or updated pull request gets an AI-powered review with severity levels and inline comments.

Check Runs

Review results appear as GitHub check runs. Critical findings block merge with REQUEST_CHANGES.

Inline Comments

Findings are posted as line-by-line review comments directly on the diff.

Issue Creation

Create GitHub issues directly from review findings for tracking and follow-up.

Environment Variables

GITHUB_APP_IDYour GitHub App ID
GITHUB_APP_PRIVATE_KEYRSA private key (PEM or base64-encoded)
GITHUB_APP_WEBHOOK_SECRETWebhook secret for event verification

GitLab

Connect your GitLab account for automatic merge request reviews. Works with both gitlab.com and self-hosted GitLab instances.

Setup

  1. Connect GitLab from the settings page via OAuth
  2. For self-hosted GitLab, register your own OAuth application and enter the instance URL and credentials
  3. Select projects to monitor — project webhooks are created automatically
  4. MRs are reviewed automatically on open and update

MR Reviews

Automatic reviews on merge request creation and updates, with severity-rated findings.

Inline Comments

Findings posted as line-by-line discussion notes directly on the MR diff.

Self-Hosted Support

Bring your own GitLab instance. Per-org OAuth credentials override gitlab.com defaults.

Project Webhooks

One webhook per project is registered at sync time — no Premium tier required.

Environment Variables

GITLAB_CLIENT_IDOAuth application ID for gitlab.com
GITLAB_CLIENT_SECRETOAuth application secret for gitlab.com
GITLAB_REDIRECT_URIOAuth callback URL, e.g. https://octopus-review.ai/api/gitlab/callback

Bitbucket

Connect your Bitbucket workspace for automated PR reviews with OAuth-based authentication.

Setup

  1. Connect Bitbucket from the settings page via OAuth
  2. Webhooks are created automatically for selected repositories
  3. Reviews are posted as PR comments with inline code feedback

PR Reviews

Automatic reviews on pull request creation and updates.

Inline Comments

Findings posted as inline comments on specific lines in the diff.

Webhooks

Automatic webhook management for real-time PR event processing.

Environment Variables

BITBUCKET_CLIENT_IDOAuth consumer key
BITBUCKET_CLIENT_SECRETOAuth consumer secret

Linear

Create Linear issues directly from code review findings. Track and assign bugs discovered during reviews.

Setup

  1. Connect Linear via OAuth from the settings page
  2. Select the default team for issue creation
  3. Create issues from any review finding with one click

Issue Creation

Turn review findings into Linear issues with title, description, priority, and team assignment.

Status Tracking

Track issue status directly from the Octopus dashboard.

Jira

Turn code review findings into Jira issues. Connect your Atlassian Cloud site to track bugs and improvements alongside your existing workflow.

Setup

  1. Connect Jira via OAuth from the settings page
  2. Select the Atlassian site and default project for issue creation
  3. Create issues from any review finding with one click

Issue Creation

Turn review findings into Jira issues with title, description, issue type, and project assignment.

Status Tracking

Track issue status directly from the Octopus dashboard without leaving the review.

Environment Variables

JIRA_CLIENT_IDAtlassian OAuth 2.0 (3LO) client ID
JIRA_CLIENT_SECRETAtlassian OAuth 2.0 (3LO) client secret
JIRA_REDIRECT_URIOAuth callback URL, e.g. https://octopus-review.ai/api/jira/callback

Slack

Ask questions about your codebase and get notifications in Slack. Octopus searches your code, docs, and review history to answer.

Setup

  1. Install the Octopus Slack app from the settings page
  2. Select channels and configure event notifications
  3. Use /octopus to ask questions about your codebase

/octopus Command

Ask questions about your codebase in any channel. Octopus searches code, docs, reviews, and knowledge base to answer.

Event Notifications

Get notified when reviews complete, repos are indexed, or knowledge documents are ready.

Configurable events:

review-requestedreview-completedreview-failedrepo-indexedrepo-analyzedknowledge-ready