Getting Started
- Install Revisor from the Atlassian Marketplace into your Bitbucket Cloud workspace.
- Open Workspace Settings — navigate to your Bitbucket workspace settings and find "Revisor Settings" in the sidebar under Apps.
- Select an AI provider from the dropdown (e.g., Anthropic, OpenAI, Google Gemini).
- Paste your API key for the selected provider. Keys are stored securely in Atlassian Forge encrypted storage.
- Choose a model from the available options for your provider.
- Open a pull request — Revisor will automatically review it and post inline comments.
No API key yet? Revisor includes a free trial mode with 5 reviews. See Trial Mode below.
AI Providers & Models
Revisor supports 6 AI providers. Bring your own API key from any of them:
| Provider | Models | API Key |
|---|---|---|
| Anthropic | Claude Opus 4.6, Claude Sonnet 4.6, Claude Haiku 4.5 | console.anthropic.com |
| OpenAI | o3, o4-mini, GPT-4.1, GPT-4.1 mini | platform.openai.com |
| Google Gemini | Gemini 2.5 Pro, Gemini 2.5 Flash | aistudio.google.com |
| Mistral | Mistral Large, Devstral | console.mistral.ai |
| DeepSeek | DeepSeek Chat V3, DeepSeek Reasoner R1 | platform.deepseek.com |
| Alibaba Qwen | Qwen Max, Qwen Plus, Qwen Turbo | dashscope.console.aliyun.com |
Trial Mode
New installations without any configured API key automatically get free AI reviews:
- 5 free reviews
- Uses Claude Haiku 4.5 (fast and cost-efficient)
- No API key or credit card required
Once the trial is exhausted, Revisor posts a single comment explaining how to configure your own API key. After that, PRs are silently skipped until a key is added.
Workspaces with any configured API key (from any provider) bypass trial mode entirely.
How Reviews Work
When a pull request is created or updated:
- Revisor automatically picks up the PR and reads the diff.
- The diff is analyzed by your configured AI provider with language-specific review prompts.
- Each finding is posted as an inline comment on the exact line, with severity and a suggested fix.
- A summary comment is posted with the overall assessment.
The entire process typically takes 10–60 seconds depending on the PR size and AI model.
AI Reply Threads
When you reply to a Revisor comment on a PR, the AI reads your reply and responds in context. If your reply addresses the concern (e.g., you explain why the code is correct), the AI can resolve the thread automatically.
This works for all review comments posted by Revisor and supports conversational back-and-forth.
Custom Repository Instructions
You can customize how Revisor reviews code in a specific repository by creating a .bitbucket/instructions file at the root of your repo.
This file can contain any plain-text coding standards, rules, or guidelines. For example:
- Always use async/await, never raw promises
- All public functions must have JSDoc comments
- Flag any use of console.log in production code
- Ensure all SQL queries use parameterized statementsWhen a PR that modifies this file is merged, Revisor automatically consolidates the instructions into structured review rules and stores them. These rules are prepended to the AI review prompt for every future PR in that repository.
Language Profiles
Revisor includes specialized review prompts for 28+ languages and file types, including JavaScript, TypeScript, Python, Go, Rust, Java, Kotlin, C#, Ruby, PHP, Swift, SQL, Terraform, Dockerfiles, and more. Each profile targets language-specific pitfalls and best practices.
Files not matching a specific profile are reviewed using a general-purpose prompt.
Disabling Reviews
To temporarily disable reviews, open the Revisor Settings page in your Bitbucket workspace settings and toggle the "AI Reviews Enabled" switch off. You can re-enable at any time.
To completely remove Revisor, uninstall the app from your workspace settings. All stored data (settings, API keys, trial counters, repo instructions) will be permanently deleted.