Learn how to use DeepReview

Quick Start

Get your team up and running with DeepReview in under 10 minutes. This guide walks you through integrating AI-powered code reviews into your Git workflow.

Prerequisites

• Admin access to your Git repository (GitHub, GitLab, or Gitee)
• A DeepReview enterprise account (contact us to get started)
• SSH key pair for repository access, or a deploy token (for token-based authentication)

Step 1: Get Your Enterprise Account

Contact our team to create your enterprise account. Once created, you'll receive:

• Enterprise Name: Your unique identifier for login
• Initial Password: Your temporary password (change it after first login)

Step 2: Login to Enterprise Portal

Access the enterprise portal at:

https://www.deepcodereviewer.com/portal

Enter your enterprise name and password to log in. After your first login, we strongly recommend changing your password for security.

Step 3: Add Your Repository

Once logged in, navigate to the Repositories tab and click the "+ Add Repository" button.

Enterprise Portal - Repositories Page

Fill in the repository details in the form. DeepReview supports two authentication methods:

Option A: SSH Key Authentication

1. Name: Enter a display name for your repository (e.g., "my-project")
2. Authentication Method: Select "SSH Key"
3. Repository URL: Enter the SSH URL (e.g., git@github.com:your-org/your-repo.git)
4. SSH Private Key: Paste your SSH private key (must have read access to the repository)
5. Enable code reviews: Check this box to activate automatic reviews
6. Click "Add Repository" to save

Option B: Token Authentication

1. Name: Enter a display name for your repository (e.g., "my-project")
2. Authentication Method: Select "Token"
3. Git Clone Command: Paste the full clone command with embedded credentials. The required format is:

   git clone https://<username>:<deploy_token>@gitlab.example.com/group/project.git

   Important: The input must follow the exact format above — starting with git clone, followed by an HTTPS URL containing credentials (username:token@host). Token credentials will be encrypted and stored securely. The repository URL will be automatically extracted from the clone command.
4. Enable code reviews: Check this box to activate automatic reviews
5. Click "Add Repository" to save

Add Repository Form

ssh-keygen -t ed25519 -C "deepreview@your-company.com" -f deploy_key

Step 4: Configure Webhook

Set up a webhook in your Git platform to notify DeepReview when code is pushed:

https://www.deepcodereviewer.com/api/webhook/<your-enterprise-name>

GitHub Setup

1. Go to your repository → Settings → Webhooks → Add webhook
2. Set Payload URL to the webhook URL above
3. Set Content type to application/json
4. Select "Just the push event"
5. Click Add webhook

GitLab Setup

1. Go to your project → Settings → Webhooks
2. Enter the webhook URL above
3. Check Push events
4. Click Add webhook

Gitee Setup

1. Go to your repository → Management → WebHooks → Add WebHook
2. Enter the webhook URL above
3. Select Push event
4. Click Add

Step 5: Push Code and Get Reviews

That's it! Now when you push code to your repository, DeepReview will automatically:

1. Receive the webhook notification from your Git platform
2. Clone your repository and analyze the code changes
3. Use the ReAct AI engine to perform deep code review
4. Generate a detailed review report within minutes

View all your review tasks in the enterprise portal under the Review Tasks tab:

Code Review Tasks - Monitor review status and access reports

Click "View Report" on any completed task to see the detailed AI code review:

Detailed Code Review Report - Including change summary, file analysis, and AI recommendations

Installation

DeepReview is available as a cloud-based SaaS platform for seamless integration with your development workflow.

Cloud SaaS Platform

The fastest and easiest way to get started. No infrastructure management required.

1. Contact our sales team to create your enterprise account
2. Receive your enterprise credentials (name and initial password)
3. Login to the enterprise portal at www.deepcodereviewer.com/portal
4. Add your repositories with SSH keys or deploy tokens
5. Configure webhooks in your Git platform
6. Start receiving AI-powered code reviews automatically

Self-Hosted Deployment (Enterprise)

For organizations with specific compliance or data sovereignty requirements, private deployment options are available.

ReAct Engine

The ReAct (Reasoning and Action) engine is the core of DeepReview's intelligent code review capability. Unlike traditional static analyzers that apply fixed rules, ReAct enables the AI to think, explore, and iterate until it fully understands the code changes.

How It Works

The ReAct engine operates in iterative cycles, similar to how a human reviewer would approach code:

Example ReAct Flow

# Thought 1
The PR modifies the authentication function. I need to understand 
how the password hashing is implemented.

# Action 1
read_file("src/auth/password.ts")

# Observation 1
File contains bcrypt implementation with salt rounds = 10

# Thought 2
I see a potential security issue - the salt rounds are hardcoded.
Let me check if there's a config file for security settings.

# Action 2
search_code("salt.*rounds", "src/", "*.ts")

# Observation 2
Found: config/security.ts defines SALT_ROUNDS constant

# Thought 3
The PR should reference the config constant instead of hardcoding.
I have enough context to generate the review.

Available Tools

The AI agent has access to the following tools during review:

Review Workflow

Understanding the complete flow from PR creation to review completion.

Synchronous vs Asynchronous Mode

Review Output Structure

Each review generates multiple outputs:

• Detailed Report: Full analysis with all findings
• Summary: Executive summary for quick overview
• Suggestions List: Actionable items with severity levels
• Inline Comments: Posted directly on PR lines

Severity Levels

Retry & Fault Tolerance

DeepReview implements multiple layers of fault tolerance to ensure reliable reviews.

Retry Strategy