OctopusOctopus/Docs/Integrations
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

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.

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