cc-reviewer 3.0.0 → 4.0.0

package/commands/claude-review.md

@@ -0,0 +1,92 @@
+# Claude Review
+
+Get a review from a fresh Claude (Opus) instance with clean context — zero memory of this session.
+
+## Arguments
+- `$ARGUMENTS` - Optional: focus area or custom instructions
+
+## Claude Strengths
+- **Deep Analysis**: Thorough reasoning across all dimensions
+- **Correctness**: Logic errors, edge cases, subtle bugs
+- **Security**: Vulnerability detection, auth analysis
+- **Architecture**: Design patterns, coupling, abstractions
+- **Clean Context**: No confirmation bias from the current session
+
+## Before Calling - PREPARE THE HANDOFF
+
+### 1. Summarize What You Did (Brief!)
+```
+"Implemented WebSocket reconnection with exponential backoff
+and added session persistence across reconnects."
+```
+
+### 2. List Your Uncertainties
+What should Claude verify?
+
+```
+UNCERTAINTIES:
+- "Is the backoff strategy correct for this use case?"
+- "Could there be a race condition between reconnect and message send?"
+```
+
+### 3. Ask Specific Questions
+```
+QUESTIONS:
+- "Is the session token handling secure during reconnect?"
+- "Should I handle partial message delivery differently?"
+```
+
+## Tool Invocation
+
+Call `claude_review` with:
+
+```json
+{
+  "workingDir": "<current directory>",
+  "ccOutput": "<structured handoff - see below>",
+  "outputType": "analysis",
+  "focusAreas": ["<from $ARGUMENTS>"]
+}
+```
+
+### Structure your ccOutput:
+
+```
+SUMMARY:
+<what you did, 1-3 sentences>
+
+UNCERTAINTIES (verify these):
+1. <your uncertainty>
+2. <another uncertainty>
+
+QUESTIONS:
+1. <specific question>
+
+KEY DECISIONS:
+- <decision>: <rationale>
+
+PRIORITY FILES:
+- <file to focus on>
+```
+
+## After Receiving Review
+
+1. **Verify file references exist**
+   - Check mentioned file:line locations
+   - Flag any that don't exist
+
+2. **Cross-check findings**
+   - Read the actual code
+   - Confirm the issue exists
+
+3. **Mark confidence:**
+   - ✓✓ Verified by you
+   - ✓ Plausible, not verified
+   - ? Needs investigation
+   - ✗ Rejected
+
+4. **Apply judgment**
+   - You may disagree with findings
+   - Make YOUR recommendation
+
+$ARGUMENTS

package/commands/multi-review.md

@@ -1,13 +1,13 @@
 # Multi Review
 
-Get parallel reviews from both Codex and Gemini, raw output for manual synthesis.
+Get parallel reviews from Codex, Gemini, and a fresh Claude (Opus) instance, raw output for manual synthesis.
 
 ## Arguments
 - `$ARGUMENTS` - Optional: focus area or custom instructions
 
 ## When to Use
 
-Use `/multi-review` when you want parallel reviews from both Codex and Gemini.
+Use `/multi-review` when you want parallel reviews from Codex, Gemini, and a fresh Claude (Opus) instance.
 
 ## Before Calling - PREPARE THE HANDOFF
 

package/dist/adapters/claude.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Claude CLI Adapter
+ *
+ * Implements the ReviewerAdapter interface for Anthropic's Claude CLI.
+ * Spawns a FRESH Claude Code instance with zero session context.
+ * Returns raw text — CC handles interpretation.
+ *
+ * Read-only enforcement (defense-in-depth):
+ *   1. --permission-mode plan     (CLI-level read-only)
+ *   2. --disallowed-tools         (write tools explicitly blocked)
+ *   3. Handoff prompt             (explicit READ-ONLY instruction)
+ */
+import { ReviewerAdapter, ReviewerCapabilities, ReviewRequest, ReviewResult } from './base.js';
+export declare class ClaudeAdapter implements ReviewerAdapter {
+    readonly id = "claude";
+    getCapabilities(): ReviewerCapabilities;
+    isAvailable(): Promise<boolean>;
+    runReview(request: ReviewRequest): Promise<ReviewResult>;
+    private runCli;
+    private handleException;
+    private categorizeError;
+    private getSuggestion;
+}
+export declare const claudeAdapter: ClaudeAdapter;

package/dist/adapters/claude.js

@@ -0,0 +1,175 @@
+/**
+ * Claude CLI Adapter
+ *
+ * Implements the ReviewerAdapter interface for Anthropic's Claude CLI.
+ * Spawns a FRESH Claude Code instance with zero session context.
+ * Returns raw text — CC handles interpretation.
+ *
+ * Read-only enforcement (defense-in-depth):
+ *   1. --permission-mode plan     (CLI-level read-only)
+ *   2. --disallowed-tools         (write tools explicitly blocked)
+ *   3. Handoff prompt             (explicit READ-ONLY instruction)
+ */
+import { spawn } from 'child_process';
+import { existsSync } from 'fs';
+import { registerAdapter, } from './base.js';
+import { CliExecutor } from '../executor.js';
+import { ClaudeEventDecoder } from '../decoders/index.js';
+import { buildSimpleHandoff, buildHandoffPrompt, selectRole, } from '../handoff.js';
+// =============================================================================
+// CONFIGURATION
+// =============================================================================
+const INACTIVITY_TIMEOUT_MS = 300_000; // 5 min — Opus has long thinking phases
+const MAX_TIMEOUT_MS = 3_600_000; // 60 min absolute max
+const MAX_BUFFER_SIZE = 1024 * 1024; // 1MB max buffer
+// Write tools explicitly blocked as defense-in-depth
+const DISALLOWED_TOOLS = 'Edit Write NotebookEdit';
+// =============================================================================
+// CLAUDE ADAPTER
+// =============================================================================
+export class ClaudeAdapter {
+    id = 'claude';
+    getCapabilities() {
+        return {
+            name: 'Claude',
+            description: 'Anthropic Claude (Opus) - fresh instance with clean context, excels at deep analysis across all dimensions',
+            strengths: ['correctness', 'security', 'architecture', 'maintainability'],
+            weaknesses: [],
+            hasFilesystemAccess: true,
+            supportsStructuredOutput: false,
+            maxContextTokens: 200000,
+            reasoningLevels: undefined,
+        };
+    }
+    async isAvailable() {
+        return new Promise((resolve) => {
+            const proc = spawn('claude', ['--version'], {
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            proc.on('close', (code) => resolve(code === 0));
+            proc.on('error', () => resolve(false));
+            setTimeout(() => { proc.kill(); resolve(false); }, 5000);
+        });
+    }
+    async runReview(request) {
+        const startTime = Date.now();
+        if (!existsSync(request.workingDir)) {
+            return {
+                success: false,
+                error: { type: 'cli_error', message: `Working directory does not exist: ${request.workingDir}` },
+                suggestion: 'Check that the working directory path is correct',
+                executionTimeMs: Date.now() - startTime,
+            };
+        }
+        try {
+            const handoff = buildSimpleHandoff(request.workingDir, request.ccOutput, request.analyzedFiles, request.focusAreas, request.customPrompt);
+            const role = selectRole(request.focusAreas);
+            const prompt = buildHandoffPrompt({ handoff, role });
+            const result = await this.runCli(prompt, request.workingDir);
+            if (result.exitCode !== 0) {
+                const error = this.categorizeError(result.stderr);
+                return { success: false, error, suggestion: this.getSuggestion(error), executionTimeMs: Date.now() - startTime };
+            }
+            if (!result.stdout.trim()) {
+                return {
+                    success: false,
+                    error: { type: 'cli_error', message: 'Claude returned empty response' },
+                    suggestion: 'Try again or use /codex-review instead',
+                    executionTimeMs: Date.now() - startTime,
+                };
+            }
+            return { success: true, output: result.stdout, executionTimeMs: Date.now() - startTime };
+        }
+        catch (error) {
+            return this.handleException(error, startTime);
+        }
+    }
+    async runCli(prompt, workingDir) {
+        const args = [
+            '-p', // Non-interactive, print and exit
+            '--model', 'opus', // Use Opus
+            '--permission-mode', 'plan', // Read-only enforcement (layer 1)
+            '--verbose', // Required for stream-json
+            '--output-format', 'stream-json', // Structured streaming events
+            '--no-session-persistence', // Ephemeral — no trace
+            '--disable-slash-commands', // No skills — minimal startup
+            '--disallowed-tools', DISALLOWED_TOOLS, // Block write tools (layer 2)
+            '-', // Read prompt from stdin
+        ];
+        const decoder = new ClaudeEventDecoder();
+        const cliStartTime = Date.now();
+        console.error('[claude] Running Opus review...');
+        decoder.onProgress = (eventType, detail) => {
+            const elapsed = Math.round((Date.now() - cliStartTime) / 1000);
+            const detailStr = detail ? ` — ${detail}` : '';
+            console.error(`[claude] ${eventType}${detailStr} (${elapsed}s)`);
+        };
+        const executor = new CliExecutor({
+            command: 'claude',
+            args,
+            cwd: workingDir,
+            stdin: prompt,
+            inactivityTimeoutMs: INACTIVITY_TIMEOUT_MS,
+            maxTimeoutMs: MAX_TIMEOUT_MS,
+            maxBufferSize: MAX_BUFFER_SIZE,
+            onLine: (line) => {
+                decoder.processLine(line);
+            },
+        });
+        const result = await executor.run();
+        const elapsed = Math.round((Date.now() - cliStartTime) / 1000);
+        console.error(`[claude] ✓ complete (${elapsed}s)`);
+        // Check for errors captured from stream events
+        const decoderError = decoder.getError();
+        if (decoderError) {
+            return { stdout: '', stderr: decoderError, exitCode: 1, truncated: false };
+        }
+        const finalResponse = decoder.getFinalResponse();
+        if (!finalResponse && decoder.hasNoOutput()) {
+            return { stdout: '', stderr: 'No response from Claude — possible rate limit or auth issue', exitCode: 1, truncated: false };
+        }
+        return {
+            stdout: finalResponse || result.rawStdout,
+            stderr: result.stderr,
+            exitCode: result.exitCode,
+            truncated: result.truncated,
+        };
+    }
+    handleException(error, startTime) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            return { success: false, error: { type: 'cli_not_found', message: 'Claude CLI not found' },
+                suggestion: 'Install Claude Code: https://docs.anthropic.com/en/docs/claude-code', executionTimeMs: Date.now() - startTime };
+        }
+        if (err.message === 'TIMEOUT') {
+            return { success: false, error: { type: 'timeout', message: 'Claude timed out — no events received' },
+                suggestion: 'Try a smaller scope or use /codex-review', executionTimeMs: Date.now() - startTime };
+        }
+        if (err.message === 'MAX_TIMEOUT') {
+            return { success: false, error: { type: 'timeout', message: 'Task exceeded 60 minute maximum' },
+                suggestion: 'Try a smaller scope', executionTimeMs: Date.now() - startTime };
+        }
+        return { success: false, error: { type: 'cli_error', message: err.message }, executionTimeMs: Date.now() - startTime };
+    }
+    categorizeError(stderr) {
+        const lower = stderr.toLowerCase();
+        if (lower.includes('rate limit') || lower.includes('quota') || lower.includes('no response from claude')) {
+            return { type: 'rate_limit', message: 'Claude rate limit — try again later' };
+        }
+        if (lower.includes('unauthorized') || lower.includes('authentication') || lower.includes('api key') || stderr.includes('401') || stderr.includes('403')) {
+            return { type: 'auth_error', message: 'Authentication failed', details: { stderr } };
+        }
+        return { type: 'cli_error', message: stderr || 'Unknown error' };
+    }
+    getSuggestion(error) {
+        switch (error.type) {
+            case 'rate_limit': return 'Wait and retry, or use /codex-review or /gemini-review instead';
+            case 'auth_error': return 'Run `claude auth` to authenticate';
+            case 'cli_not_found': return 'Install Claude Code: https://docs.anthropic.com/en/docs/claude-code';
+            default: return 'Check the error message and try again';
+        }
+    }
+}
+// Register the adapter
+registerAdapter(new ClaudeAdapter());
+export const claudeAdapter = new ClaudeAdapter();

package/dist/adapters/codex.js

@@ -87,7 +87,8 @@ export class CodexAdapter {
             '-m', 'gpt-5.4',
             '-c', `model_reasoning_effort=${reasoningEffort}`,
             '-c', 'model_reasoning_summary_format=experimental',
-            '--dangerously-bypass-approvals-and-sandbox',
+            '--full-auto',
+            '--sandbox', 'read-only',
             '--skip-git-repo-check',
             '-C', workingDir,
             '-', // Read prompt from stdin

package/dist/adapters/gemini.js

@@ -79,7 +79,8 @@ export class GeminiAdapter {
     }
     async runCli(prompt, workingDir) {
         const args = [
-            '--yolo',
+            '--sandbox',
+            '--approval-mode', 'plan',
             '--output-format', 'stream-json',
             '--include-directories', workingDir,
             '-p', '',

package/dist/adapters/index.d.ts

@@ -5,6 +5,8 @@
  */
 import './codex.js';
 import './gemini.js';
+import './claude.js';
 export * from './base.js';
 export { codexAdapter } from './codex.js';
 export { geminiAdapter } from './gemini.js';
+export { claudeAdapter } from './claude.js';

package/dist/adapters/index.js

@@ -6,8 +6,10 @@
 // Import adapters to register them
 import './codex.js';
 import './gemini.js';
+import './claude.js';
 // Re-export everything from base
 export * from './base.js';
 // Export specific adapters
 export { codexAdapter } from './codex.js';
 export { geminiAdapter } from './gemini.js';
+export { claudeAdapter } from './claude.js';

package/dist/cli/check.js

@@ -22,11 +22,12 @@ async function commandExists(command) {
  * Check availability of all supported CLIs
  */
 export async function checkCliAvailability() {
-    const [codex, gemini] = await Promise.all([
+    const [codex, gemini, claude] = await Promise.all([
         commandExists('codex'),
-        commandExists('gemini')
+        commandExists('gemini'),
+        commandExists('claude')
     ]);
-    return { codex, gemini };
+    return { codex, gemini, claude };
 }
 /**
  * Check if a specific CLI is available
@@ -67,9 +68,11 @@ export async function logCliStatus() {
     console.error('AI Reviewer CLI Status:');
     console.error(`  - Codex: ${status.codex ? '✓ Available' : '✗ Not found'}`);
     console.error(`  - Gemini: ${status.gemini ? '✓ Available' : '✗ Not found'}`);
-    if (!status.codex && !status.gemini) {
-        console.error('\nWarning: No AI CLIs found. Install with:');
+    console.error(`  - Claude: ${status.claude ? '✓ Available' : '✗ Not found'}`);
+    if (!status.codex && !status.gemini && !status.claude) {
+        console.error('\nWarning: No AI CLIs found. Install at least one:');
         console.error('  npm install -g @openai/codex-cli');
         console.error('  npm install -g @google/gemini-cli');
+        console.error('  Claude Code: https://docs.anthropic.com/en/docs/claude-code');
     }
 }

package/dist/decoders/claude.d.ts

@@ -0,0 +1,53 @@
+/**
+ * ClaudeEventDecoder — Parses Claude CLI stream-json JSONL events.
+ *
+ * Event stream format (with --output-format stream-json --verbose):
+ *   {"type":"system","subtype":"init",...}
+ *   {"type":"assistant","message":{"content":[{"type":"text","text":"..."}],...},...}
+ *   {"type":"result","subtype":"success","result":"...","duration_ms":...,"usage":{...}}
+ */
+export interface ClaudeEvent {
+    type: string;
+    subtype?: string;
+    session_id?: string;
+    model?: string;
+    result?: string;
+    is_error?: boolean;
+    duration_ms?: number;
+    message?: {
+        content?: Array<{
+            type: string;
+            text?: string;
+        }>;
+        usage?: {
+            input_tokens: number;
+            output_tokens: number;
+            cache_read_input_tokens?: number;
+            cache_creation_input_tokens?: number;
+        };
+    };
+    usage?: {
+        input_tokens: number;
+        output_tokens: number;
+        cache_read_input_tokens?: number;
+        cache_creation_input_tokens?: number;
+    };
+    tool_use_id?: string;
+    tool_name?: string;
+}
+export declare class ClaudeEventDecoder {
+    onProgress?: (eventType: string, detail?: string) => void;
+    private _finalResponse;
+    private _usage;
+    private _error;
+    private _eventCount;
+    private _durationMs;
+    processLine(line: string): void;
+    getFinalResponse(): string | null;
+    getUsage(): ClaudeEvent['usage'] | null;
+    getError(): string | null;
+    getDurationMs(): number | null;
+    hasNoOutput(): boolean;
+    private _handleEvent;
+    private _describeEvent;
+}

package/dist/decoders/claude.js

@@ -0,0 +1,106 @@
+/**
+ * ClaudeEventDecoder — Parses Claude CLI stream-json JSONL events.
+ *
+ * Event stream format (with --output-format stream-json --verbose):
+ *   {"type":"system","subtype":"init",...}
+ *   {"type":"assistant","message":{"content":[{"type":"text","text":"..."}],...},...}
+ *   {"type":"result","subtype":"success","result":"...","duration_ms":...,"usage":{...}}
+ */
+// =============================================================================
+// DECODER
+// =============================================================================
+export class ClaudeEventDecoder {
+    onProgress;
+    _finalResponse = null;
+    _usage = null;
+    _error = null;
+    _eventCount = 0;
+    _durationMs = null;
+    // =============================================================================
+    // PUBLIC API
+    // =============================================================================
+    processLine(line) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0)
+            return;
+        let event;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+                return;
+            event = parsed;
+        }
+        catch {
+            return;
+        }
+        if (!event.type)
+            return;
+        this._handleEvent(event);
+    }
+    getFinalResponse() {
+        return this._finalResponse;
+    }
+    getUsage() {
+        return this._usage;
+    }
+    getError() {
+        return this._error;
+    }
+    getDurationMs() {
+        return this._durationMs;
+    }
+    hasNoOutput() {
+        return this._eventCount > 0 && this._finalResponse === null;
+    }
+    // =============================================================================
+    // PRIVATE HELPERS
+    // =============================================================================
+    _handleEvent(event) {
+        this._eventCount++;
+        switch (event.type) {
+            case 'result':
+                // The result event contains the final text response
+                if (event.subtype === 'success' && typeof event.result === 'string') {
+                    this._finalResponse = event.result;
+                }
+                if (event.is_error) {
+                    this._error = event.result || 'Claude review failed';
+                }
+                if (event.usage) {
+                    this._usage = event.usage;
+                }
+                if (event.duration_ms != null) {
+                    this._durationMs = event.duration_ms;
+                }
+                break;
+            case 'assistant':
+                // Track usage from assistant messages
+                if (event.message?.usage) {
+                    this._usage = event.message.usage;
+                }
+                break;
+            case 'error':
+                this._error = event.result || 'Unknown error from Claude CLI';
+                break;
+        }
+        this.onProgress?.(event.type, this._describeEvent(event));
+    }
+    _describeEvent(event) {
+        switch (event.type) {
+            case 'system':
+                if (event.subtype === 'init')
+                    return `model: ${event.model || 'opus'}`;
+                if (event.subtype)
+                    return event.subtype;
+                return undefined;
+            case 'assistant':
+                return 'assistant message';
+            case 'tool_use':
+                return event.tool_name ? `tool: ${event.tool_name}` : 'tool use';
+            case 'result':
+                return `status: ${event.subtype || 'unknown'}`;
+            default:
+                return undefined;
+        }
+    }
+}

package/dist/decoders/index.d.ts

@@ -2,3 +2,5 @@ export { CodexEventDecoder } from './codex.js';
 export type { CodexEvent } from './codex.js';
 export { GeminiEventDecoder } from './gemini.js';
 export type { GeminiEvent } from './gemini.js';
+export { ClaudeEventDecoder } from './claude.js';
+export type { ClaudeEvent } from './claude.js';

package/dist/decoders/index.js

@@ -1,2 +1,3 @@
 export { CodexEventDecoder } from './codex.js';
 export { GeminiEventDecoder } from './gemini.js';
+export { ClaudeEventDecoder } from './claude.js';

package/dist/errors.js

@@ -6,17 +6,20 @@
 // Gemini: https://github.com/google-gemini/gemini-cli
 const INSTALL_COMMANDS = {
     codex: 'npm install -g @openai/codex-cli',
-    gemini: 'npm install -g @google/gemini-cli'
+    gemini: 'npm install -g @google/gemini-cli',
+    claude: 'https://docs.anthropic.com/en/docs/claude-code'
 };
 // Environment variables for API keys
 const ENV_VARS = {
     codex: 'OPENAI_API_KEY',
-    gemini: 'GEMINI_API_KEY'
+    gemini: 'GEMINI_API_KEY',
+    claude: 'ANTHROPIC_API_KEY'
 };
 // Authentication commands
 const AUTH_COMMANDS = {
     codex: 'codex login',
-    gemini: 'gemini (follow prompts)'
+    gemini: 'gemini (follow prompts)',
+    claude: 'claude auth'
 };
 /**
  * Create a CLI not found error
@@ -83,7 +86,8 @@ export function createCliError(cli, exitCode, stderr) {
  * Format an error for user display
  */
 export function formatErrorForUser(error) {
-    const otherCli = error.cli === 'codex' ? 'gemini' : 'codex';
+    const others = ['codex', 'gemini', 'claude'].filter(c => c !== error.cli);
+    const otherCli = others[0];
     switch (error.type) {
         case 'cli_not_found':
             return `❌ ${error.cli} CLI not found.

package/dist/handoff.js

@@ -168,7 +168,9 @@ export function buildHandoffPrompt(options) {
 
 Review recent work in \`${handoff.workingDir}\`.
 
-**Summary:** ${handoff.summary}${handoff.confidence !== undefined && handoff.confidence < 0.9 ? `\n**CC Confidence:** ${Math.round(handoff.confidence * 100)}% — verify weak areas` : ''}`);
+**Summary:** ${handoff.summary}${handoff.confidence !== undefined && handoff.confidence < 0.9 ? `\n**CC Confidence:** ${Math.round(handoff.confidence * 100)}% — verify weak areas` : ''}
+
+**IMPORTANT: This is a READ-ONLY review. Do NOT create, modify, or delete any files. Only read files to verify claims.**`);
     // SECTION 3: CC'S UNCERTAINTIES
     if (handoff.uncertainties && handoff.uncertainties.length > 0) {
         sections.push(`## CC'S UNCERTAINTIES

package/dist/index.js

@@ -18,7 +18,7 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { handleCodexReview, handleGeminiReview, handleMultiReview, ReviewInputSchema, TOOL_DEFINITIONS } from './tools/feedback.js';
+import { handleCodexReview, handleGeminiReview, handleClaudeReview, handleMultiReview, ReviewInputSchema, TOOL_DEFINITIONS } from './tools/feedback.js';
 import { logCliStatus } from './cli/check.js';
 import { installCommands } from './commands.js';
 // Read version from package.json
@@ -62,6 +62,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         tools: [
             TOOL_DEFINITIONS.codex_review,
             TOOL_DEFINITIONS.gemini_review,
+            TOOL_DEFINITIONS.claude_review,
             TOOL_DEFINITIONS.multi_review,
         ],
     };
@@ -79,6 +80,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                 const input = ReviewInputSchema.parse(args);
                 return await handleGeminiReview(input);
             }
+            case 'claude_review': {
+                const input = ReviewInputSchema.parse(args);
+                return await handleClaudeReview(input);
+            }
             case 'multi_review': {
                 const input = ReviewInputSchema.parse(args);
                 return await handleMultiReview(input);

package/dist/tools/feedback.d.ts

@@ -46,6 +46,12 @@ export declare function handleGeminiReview(input: ReviewInput): Promise<{
         text: string;
     }>;
 }>;
+export declare function handleClaudeReview(input: ReviewInput): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+}>;
 export declare function handleMultiReview(input: ReviewInput): Promise<{
     content: Array<{
         type: 'text';
@@ -147,6 +153,48 @@ export declare const TOOL_DEFINITIONS: {
             required: string[];
         };
     };
+    claude_review: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                workingDir: {
+                    type: string;
+                    description: string;
+                };
+                ccOutput: {
+                    type: string;
+                    description: string;
+                };
+                outputType: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                analyzedFiles: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                focusAreas: {
+                    type: string;
+                    items: {
+                        type: string;
+                        enum: string[];
+                    };
+                    description: string;
+                };
+                customPrompt: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+        };
+    };
     multi_review: {
         name: string;
         description: string;

package/dist/tools/feedback.js

@@ -73,6 +73,16 @@ export async function handleGeminiReview(input) {
     const result = await adapter.runReview(toReviewRequest(input));
     return { content: [{ type: 'text', text: formatResult(result, 'Gemini') }] };
 }
+export async function handleClaudeReview(input) {
+    const adapter = getAdapter('claude');
+    if (!adapter)
+        return { content: [{ type: 'text', text: '❌ Claude adapter not registered' }] };
+    const available = await adapter.isAvailable();
+    if (!available)
+        return { content: [{ type: 'text', text: '❌ Claude CLI not found.\n\nInstall Claude Code: https://docs.anthropic.com/en/docs/claude-code\n\nAlternative: Use codex_review or gemini_review instead' }] };
+    const result = await adapter.runReview(toReviewRequest(input));
+    return { content: [{ type: 'text', text: formatResult(result, 'Claude (Opus)') }] };
+}
 // =============================================================================
 // MULTI-MODEL HANDLER
 // =============================================================================
@@ -140,9 +150,25 @@ export const TOOL_DEFINITIONS = {
             required: ['workingDir', 'ccOutput', 'outputType']
         }
     },
+    claude_review: {
+        name: 'claude_review',
+        description: "ONLY use when user explicitly requests '/claude-review' or 'review with claude'. Get second-opinion from a fresh Claude (Opus) instance with clean context — no memory of this session. Excels at deep analysis across all dimensions. DO NOT use for general 'review' requests.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workingDir: { type: 'string', description: 'Working directory for the CLI to operate in' },
+                ccOutput: { type: 'string', description: "Claude Code's output to review (findings, plan, analysis)" },
+                outputType: { type: 'string', enum: ['plan', 'findings', 'analysis', 'proposal'], description: 'Type of output being reviewed' },
+                analyzedFiles: { type: 'array', items: { type: 'string' }, description: 'File paths that CC analyzed' },
+                focusAreas: { type: 'array', items: { type: 'string', enum: ['security', 'performance', 'architecture', 'correctness', 'maintainability', 'scalability', 'testing', 'documentation'] }, description: 'Areas to focus the review on' },
+                customPrompt: { type: 'string', description: 'Custom instructions for the reviewer' },
+            },
+            required: ['workingDir', 'ccOutput', 'outputType']
+        }
+    },
     multi_review: {
         name: 'multi_review',
-        description: "ONLY use when user explicitly requests '/multi-review' or 'review with both codex and gemini'. Get parallel second-opinions from both external CLIs (Codex and Gemini). Returns combined reviews for synthesis. DO NOT use for general 'review' requests.",
+        description: "ONLY use when user explicitly requests '/multi-review' or 'review with all models'. Get parallel second-opinions from Codex, Gemini, and a fresh Claude (Opus) instance. Returns combined reviews for synthesis. DO NOT use for general 'review' requests.",
         inputSchema: {
             type: 'object',
             properties: {

package/dist/types.d.ts

@@ -3,7 +3,7 @@
  */
 export type OutputType = 'plan' | 'findings' | 'analysis' | 'proposal';
 export type FocusArea = 'security' | 'performance' | 'architecture' | 'correctness' | 'maintainability' | 'scalability' | 'testing' | 'documentation';
-export type CliType = 'codex' | 'gemini';
+export type CliType = 'codex' | 'gemini' | 'claude';
 export type ReasoningEffort = 'high' | 'xhigh';
 export type ServiceTier = 'default' | 'fast' | 'flex';
 export interface FeedbackRequest {
@@ -69,6 +69,7 @@ export interface MultiFeedbackResult {
 export interface CliStatus {
     codex: boolean;
     gemini: boolean;
+    claude: boolean;
 }
 export interface StructuredFeedback {
     agreements: Array<{

package/dist/types.js

@@ -11,6 +11,11 @@ export const REVIEWER_PERSONAS = {
         name: 'Gemini',
         focus: 'design patterns, scalability, tech debt',
         style: 'Think holistically - consider broader context.'
+    },
+    claude: {
+        name: 'Claude',
+        focus: 'deep analysis, correctness, security, architecture',
+        style: 'Fresh perspective with clean context - challenge assumptions.'
     }
 };
 // Focus area descriptions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-reviewer",
-  "version": "3.0.0",
+  "version": "4.0.0",
   "description": "MCP server for Claude Code - Get second-opinion feedback from Codex/Gemini CLIs",
   "type": "module",
   "main": "dist/index.js",