# Octopus

> AI code review for pull requests. Octopus reviews every PR on GitHub, GitLab, Bitbucket and Forgejo with full-repository context and posts severity-rated findings inline. Cloud service at octopus-review.ai; self-hosting is optional.

Octopus is a source-available (Modified MIT) AI code review platform. It connects to your repositories, indexes the codebase with vector search, and reviews each pull request as it is opened or updated. Findings are posted as inline review comments with a severity (Critical, Major, Minor, Suggestion, Tip), a short explanation and, where useful, a suggested patch, plus a per-PR score table. Reviews re-run when the PR changes. GitHub review-comment replies can trigger follow-up responses.

## Core features

- Automated pull request review with codebase context (vector index over the whole repository, not just the diff)
- Severity-rated findings and a per-PR quality score; re-review on new commits
- Choice of AI vendor and model per organization or per repository: Anthropic Claude (Fable 5.1, Opus 5, Sonnet 5), OpenAI (GPT-6 Astra, GPT-5.3 Codex), Google Gemini, xAI Grok (Grok 4.6), Alibaba Cloud Qwen (Qwen3.8-Max), and any model on OpenRouter (e.g. Kimi K3). Cloud default: Claude Opus 5.
- Bring your own API keys (Anthropic, OpenAI, Google, xAI, Alibaba Cloud Model Studio, OpenRouter) or pay with Octopus credits
- Organization knowledge base: custom rules and guidelines the reviewer follows
- Package analyzer, code chat, issue creation from findings, live review timeline

## Ways to use it

- GitHub App (recommended on cloud): automatic reviews on every pull request
- GitLab and Bitbucket integrations
- Forgejo: choose Cloud + public HTTPS (direct), Cloud + private LAN/VPN (local outbound connector), or self-hosted Octopus + private LAN/VPN (direct). Setup chooser: https://octopus-review.ai/docs/integrations#forgejo
- GitHub Action for CI-triggered reviews: https://octopus-review.ai/docs/github-action
- CLI `octp` for local and terminal workflows: https://octopus-review.ai/docs/cli
- AI coding agents: Claude Code, Codex, OpenCode, Hermes Agent, OpenClaw, and Cursor can use the native octp CLI and the shared Octopus skill. Setup and execution-environment requirements: https://octopus-review.ai/docs/cli/ai-agents
- Claude Code MCP plugin: add the octopusreview/octopus-plugin marketplace, install octopus-review@octopus-review, and configure its organization API token. Guide: https://octopus-review.ai/docs/cli/claude-code-integration
- Slack (ask questions about your codebase), Linear and Jira (create issues from findings): https://octopus-review.ai/docs/integrations
- Self-hosting with Docker Compose: https://octopus-review.ai/docs/self-hosting

Forgejo repositories remain on your instance, but Octopus and your configured AI services process code for reviews. Self-hosting Forgejo does not keep Octopus Cloud processing on your network. Octopus Cloud connects directly to public HTTPS instances or uses a local outbound connector for private LAN/VPN instances. The connector keeps Forgejo private; code and review context still reach Octopus Cloud and configured AI services. Self-hosted Octopus can instead connect directly over the LAN/VPN with network access and an explicit FORGEJO_ALLOWED_PRIVATE_ORIGINS allowlist. Native CLI agent setup remains GitHub-only. Cloud private setup: https://octopus-review.ai/docs/integrations#forgejo-cloud-private. Self-hosted direct setup: https://octopus-review.ai/docs/self-hosting#forgejo

## Pricing

Usage-based. Free credits on signup, no subscription. Octopus Cloud bills AI usage at 2x the provider's list price and charges nothing else; with your own API keys the model call is free and the provider bills you. Provider list prices per 1M tokens are on https://octopus-review.ai/docs/pricing.

## Documentation

- About: https://octopus-review.ai/docs/about
- Getting started: https://octopus-review.ai/docs/getting-started
- Pricing: https://octopus-review.ai/docs/pricing
- FAQ: https://octopus-review.ai/docs/faq
- Integrations: https://octopus-review.ai/docs/integrations
- CLI: https://octopus-review.ai/docs/cli
- AI coding agents: https://octopus-review.ai/docs/cli/ai-agents
- Claude Code plugin: https://octopus-review.ai/docs/cli/claude-code-integration
- GitHub Action: https://octopus-review.ai/docs/github-action
- Self-hosting: https://octopus-review.ai/docs/self-hosting
- Security overview: https://octopus-review.ai/docs/security-overview
- Sub-processors: https://octopus-review.ai/docs/sub-processors
- Privacy: https://octopus-review.ai/docs/privacy
- Terms: https://octopus-review.ai/docs/terms
- Glossary: https://octopus-review.ai/docs/glossary

## More

- Blog (model launches, product news): https://octopus-review.ai/blog
- Compared with other AI reviewers: https://octopus-review.ai/compare
- Compared with CodeRabbit: https://octopus-review.ai/vs-coderabbit
- Full documentation text for LLMs: https://octopus-review.ai/llms-full.txt
- Source: https://github.com/octopusreview/octopus
- Contact: support@octopus-review.ai