ReviewSync

Synthesize every AI and human code review into one actionable summary. ReviewSync listens for AI reviewer comments, manual commands, or workflow dispatches and produces a single consensus comment powered by Google Gemini.

Features

• Auto-trigger on supported AI reviewer comments with optional delay.
• Manual @reviewsync commands with filtering for bots, humans, and keywords.
• Workflow dispatch button for on-demand synthesis.
• Gemini-powered summarization with comprehensive, issues-only, and suggestions-only modes.
• Smart comment aggregation across issue and review comment threads.
• Idempotent comment posting—updates existing ReviewSync summaries instead of spamming.

Setup

1. Install dependencies

   npm install
   npm run build

2. Create secrets
   • GEMINI_API_KEY: Create at Google AI Studio.
   • Optional: REVIEWSYNC_AUTO_DELAY repository variable to override the default 90 second delay.
3. Commit workflows located in .github/workflows.

Usage

Automatic mode

The ReviewSync (Auto) workflow runs whenever a supported AI bot comments on a pull request. Configure the delay with the auto-delay input (default 90 s).

Command mode

Comment on the pull request with any of the following:

@reviewsync                     # AI reviews only
@reviewsync all                 # AI + human comments
@reviewsync claude coderabbit   # Specific bots
@reviewsync issues              # Critical issues only
@reviewsync suggestions         # Suggestions and improvements
@reviewsync keywords: security auth

Unknown tokens trigger an additional helper comment with syntax guidance.

Manual workflow dispatch

From the GitHub Actions tab, run ReviewSync (Manual) and supply:

• pr_number (required)
• include_human (optional)
• specific_bots (optional, comma-separated)

Configuration

Input	Description	Default
github-token	GitHub token with issue/pull permissions	required
gemini-api-key	Google Gemini API key	required
auto-delay	Delay before auto mode runs (seconds)	90
include-human	Include human comments (manual/command)	false
specific-bots	Comma-separated bot usernames	""
pr-number	PR number for manual dispatch	unset

Supported AI reviewers: CodeRabbit, Claude, Gemini Code Assist, GitHub Copilot, ChatGPT Codex. Additional bots can be added via configuration.

Development

• Type-check and build: npm run build
• Clean build artifacts: npm run clean
• The action compiles to dist/ and is executed via node dist/main.js.
• Core modules live under src/ with clear separation between triggers, collectors, synthesis, and formatting.

Testing

1. Create a .env file (see .env.example) with tokens for local testing.
2. Run node dist/main.js with required environment variables:

   GITHUB_TOKEN=... GEMINI_API_KEY=... node dist/main.js

3. Use the command workflow on a test pull request and verify that:
   • A summary comment is posted/updated.
   • The details section lists the analyzed reviewers.
   • Filters (bots, keywords, humans) behave as expected.

Cost

Gemini 2.0 Flash currently costs roughly $0.006 per synthesis. With the initial $300 Google Cloud credit you can run about 50,000 syntheses.

License

MIT © ReviewSync contributors