Octopus is free for open source projects
Public repositories get unlimited AI code reviews on every pull request — no credit card, no monthly quota, no strings attached. We believe maintainers deserve great tooling.
One workflow file. Reviews on every PR.
Drop the YAML below into .github/workflows/octopus.yml, commit it, and your next pull request will get an inline review from Octopus with severity-rated findings.
Quick start
The Octopus GitHub Action runs on every pull_request event, posts inline review comments, and exits cleanly when the review is done. You don't need to install anything else, sign up, or generate API keys — the action handles authentication via the ephemeral GITHUB_TOKEN.
# .github/workflows/octopus.yml
name: Octopus Review
on:
pull_request:
types: [opened, synchronize]
permissions:
contents: read
pull-requests: write
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: octopusreview/action@v1
That's the whole setup. Open a pull request and Octopus will comment within a couple of minutes.
What's included
Unlimited PR reviews
Every opened or updated pull request gets a context-aware review. No monthly cap.
Codebase indexing
Your repo is indexed so reviews understand patterns and architecture, not just the diff.
Security & bug detection
Critical, Major, Minor, Suggestion, and Tip severity levels on every finding.
No data retention
Source is processed in-memory. We never train on your code or persist diffs.
Who qualifies
The free tier is for projects that are genuinely open source — public repositories with an OSI-approved license. Specifically:
- The repository is public on GitHub.
- It has an OSI-approved license (MIT, Apache-2.0, GPL, BSD, MPL, etc.).
- It is not the public mirror of a commercial product gated behind a paid plan.
Working on a private repo or a commercial project? Check the pricing page for credits and bring-your-own-key options.
Tips for maintainers
Skip generated code, fixtures, and vendored dependencies so reviews stay focused.
Give Octopus your CONTRIBUTING.md or architecture notes for sharper, project-specific reviews.
Prefer webhook-driven reviews instead of Actions? Install the GitHub App from the integrations page.