How neshaki091/open-code-review works
OpenCodeReview is an AI code-review CLI, with a VS Code extension as an interactive front end. The main workflow selects and parses Git changes, applies deterministic review selection, then runs an LLM agent with repository-reading tools to produce line-level comments. Whole-file scanning is a distinct review mode; sessions, provider configuration, MCP tools, and the extension’s review/configuration UI are supporting capabilities. Edges use the README or shown source references; unsampled internals are represented only where documented, so some subsystem links are omitted.
Main entry points: review_cmd.go Diff review · agent.go Review agent · loop.go Agent loop · App.tsx Review webview
Components 21
CLI and commands
- CLI entry
cmd/opencodereview/main.go - Diff review
cmd/opencodereview/review_cmd.go - Whole-file scan
cmd/opencodereview/scan_cmd.go
Review runtime
- Git diff input
internal/diff/parser.go - Review agent
internal/agent/agent.go - File selection
internal/agent/selection.go - Scan agent
internal/scan/agent.go - Agent loop
internal/llmloop/loop.go - Review tools
internal/tool/definitions.go - Comment positioning
internal/diff/resolver.go
Integrations and state
- LLM client
internal/llm/client.go - MCP integration
internal/mcp/client.go - Review rules
internal/config/template/template.go - Review sessions
internal/session/persist.go
VS Code extension
- Review webview
extensions/vscode/src/webview/App.tsx - Extension session
extensions/vscode/src/extension/services/ReviewSession.ts - CLI service
extensions/vscode/src/extension/services/CliService.ts - Provider settings UI
extensions/vscode/src/webview/components/CustomProviderManager.tsx - Config utilities
extensions/vscode/src/shared/configUtils.ts
Other components
- Developer
- LLM provider
Connections 21
- Developer → CLI entry: runs
README.md - CLI entry → Diff review: dispatches
- Developer → Whole-file scan: requests scan
README.md - Diff review → Review agent: runs review
cmd/opencodereview/review_cmd.go - Diff review → Git diff input: loads changes
README.md - Review agent → File selection: selects files
- Review agent → Agent loop: runs agent
README.md - Agent loop → LLM client: requests completions
internal/llmloop/loop.go - LLM client → LLM provider: sends prompts
README.md - Agent loop → Review tools: dispatches tools
internal/llmloop/loop.go - Diff review → MCP integration: registers tools
cmd/opencodereview/review_cmd.go - Review agent → Comment positioning: positions comments
- Diff review → Review sessions: persists session
- Whole-file scan → Scan agent: starts scan
- Developer → Review webview: reviews changes
README.md - Review webview → Extension session: starts session
- Extension session → CLI service: runs CLI
extensions/vscode/src/extension/services/ReviewSession.ts - CLI service → Diff review: invokes review
- Review webview → Provider settings UI: opens settings
extensions/vscode/src/webview/App.tsx - Provider settings UI → Config utilities: lists providers
extensions/vscode/src/webview/components/CustomProviderManager.tsx - Diff review → Review rules: uses review rules