synkraai CodeRabbit Review
Centralized CodeRabbit CLI execution for automated code review via WSL.
Prerequisites
- CodeRabbit CLI installed in WSL at
~/.local/bin/coderabbit - WSL distribution: Ubuntu
- Authenticated:
wsl bash -c '~/.local/bin/coderabbit auth status'
Execution
1. Determine Scope
Parse $ARGUMENTS to determine review scope:
| Argument | Command | Use Case |
|---|---|---|
uncommitted (default) |
--prompt-only -t uncommitted |
Pre-commit review |
committed |
--prompt-only -t committed --base main |
QA story review |
base {branch} |
--prompt-only --base {branch} |
Pre-PR review against specific base |
2. Build WSL Command
wsl bash -c 'cd /mnt/c/path/to/aiox-core && ~/.local/bin/coderabbit {flags}'
Timeout: 15 minutes (900000ms) — CodeRabbit reviews take 7-30 min.
3. Execute Review
Run the command via Bash tool with appropriate timeout.
4. Parse Results
Classify findings by severity:
| Severity | Action |
|---|---|
| CRITICAL | Must fix immediately — blocks completion |
| HIGH | Recommend fix before merge |
| MEDIUM | Document as technical debt |
| LOW | Optional improvement, note only |
5. Self-Healing Loop (if CRITICAL found)
iteration = 0
max_iterations = agent-specific (dev: 2, qa: 3, devops: 2)
WHILE iteration < max_iterations AND critical_issues_remain:
1. Attempt auto-fix for each CRITICAL issue
2. Re-run CodeRabbit review
3. iteration++
IF critical_issues_remain after max_iterations:
HALT and report to user
6. Report
Output a summary table:
## CodeRabbit Review Results
| Severity | Count | Status |
|----------|-------|--------|
| CRITICAL | N | Fixed/Remaining |
| HIGH | N | Documented |
| MEDIUM | N | Tech debt |
| LOW | N | Noted |
**Decision:** PASS / FAIL
Error Handling
| Error | Cause | Resolution |
|---|---|---|
coderabbit: command not found |
Not installed in WSL | wsl bash -c 'pip install coderabbit-cli' |
| Timeout (>15 min) | Large review | Increase timeout, review is still processing |
not authenticated |
Auth expired | wsl bash -c '~/.local/bin/coderabbit auth status' |
Agent-Specific Configuration
| Agent | Max Iterations | Severity Filter | Trigger |
|---|---|---|---|
| @dev | 2 | CRITICAL only | Pre-commit (story completion) |
| @qa | 3 | CRITICAL + HIGH | Story review start |
| @devops | 2 | CRITICAL + HIGH | Pre-push / Pre-PR |
Report Location
Save reports to: docs/qa/coderabbit-reports/