# neshaki091/open-code-review architecture

> Architecture diagram of the GitHub repository neshaki091/open-code-review, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/neshaki091/open-code-review
- Repository: https://github.com/neshaki091/open-code-review

## Overview

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: [`cmd/opencodereview/review_cmd.go`](https://github.com/neshaki091/open-code-review/blob/main/cmd/opencodereview/review_cmd.go) (Diff review), [`internal/agent/agent.go`](https://github.com/neshaki091/open-code-review/blob/main/internal/agent/agent.go) (Review agent), [`internal/llmloop/loop.go`](https://github.com/neshaki091/open-code-review/blob/main/internal/llmloop/loop.go) (Agent loop), [`extensions/vscode/src/webview/App.tsx`](https://github.com/neshaki091/open-code-review/blob/main/extensions/vscode/src/webview/App.tsx) (Review webview)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and commands"]
  node_cli_entry["CLI entry<br/>[main.go]"]
  node_review_cmd["Diff review<br/>[review_cmd.go]"]
  node_scan_cmd["Whole-file scan<br/>[scan_cmd.go]"]
end

subgraph group_review["Review runtime"]
  node_diff["Git diff input<br/>[parser.go]"]
  node_agent["Review agent<br/>[agent.go]"]
  node_selection["File selection<br/>[selection.go]"]
  node_scan_agent["Scan agent<br/>[agent.go]"]
  node_llm_loop["Agent loop<br/>[loop.go]"]
  node_review_tools["Review tools<br/>[definitions.go]"]
  node_comment_positioning["Comment positioning<br/>[resolver.go]"]
end

subgraph group_services["Integrations and state"]
  node_llm_client["LLM client<br/>[client.go]"]
  node_mcp["MCP integration<br/>[client.go]"]
  node_config["Review rules<br/>[template.go]"]
  node_session_store[("Review sessions<br/>[persist.go]")]
end

subgraph group_vscode["VS Code extension"]
  node_vscode_ui["Review webview<br/>[App.tsx]"]
  node_vscode_session["Extension session<br/>[ReviewSession.ts]"]
  node_cli_service["CLI service<br/>[CliService.ts]"]
  node_config_ui["Provider settings UI"]
  node_config_utils["Config utilities<br/>[configUtils.ts]"]
end

node_developer(("Developer"))
node_model_service{{"LLM provider"}}

node_developer -->|"runs"| node_cli_entry
node_cli_entry -.->|"dispatches"| node_review_cmd
node_developer -->|"requests scan"| node_scan_cmd
node_review_cmd -->|"runs review"| node_agent
node_review_cmd -->|"loads changes"| node_diff
node_agent -->|"selects files"| node_selection
node_agent -->|"runs agent"| node_llm_loop
node_llm_loop -->|"requests completions"| node_llm_client
node_llm_client -->|"sends prompts"| node_model_service
node_llm_loop -->|"dispatches tools"| node_review_tools
node_review_cmd -->|"registers tools"| node_mcp
node_agent -.->|"positions comments"| node_comment_positioning
node_review_cmd -.->|"persists session"| node_session_store
node_scan_cmd -.->|"starts scan"| node_scan_agent
node_developer -->|"reviews changes"| node_vscode_ui
node_vscode_ui -.->|"starts session"| node_vscode_session
node_vscode_session -->|"runs CLI"| node_cli_service
node_cli_service -.->|"invokes review"| node_review_cmd
node_vscode_ui -->|"opens settings"| node_config_ui
node_config_ui -->|"lists providers"| node_config_utils
node_review_cmd -.->|"uses review rules"| node_config

click node_cli_entry "https://github.com/neshaki091/open-code-review/blob/main/cmd/opencodereview/main.go"
click node_review_cmd "https://github.com/neshaki091/open-code-review/blob/main/cmd/opencodereview/review_cmd.go"
click node_scan_cmd "https://github.com/neshaki091/open-code-review/blob/main/cmd/opencodereview/scan_cmd.go"
click node_diff "https://github.com/neshaki091/open-code-review/blob/main/internal/diff/parser.go"
click node_agent "https://github.com/neshaki091/open-code-review/blob/main/internal/agent/agent.go"
click node_selection "https://github.com/neshaki091/open-code-review/blob/main/internal/agent/selection.go"
click node_scan_agent "https://github.com/neshaki091/open-code-review/blob/main/internal/scan/agent.go"
click node_llm_loop "https://github.com/neshaki091/open-code-review/blob/main/internal/llmloop/loop.go"
click node_review_tools "https://github.com/neshaki091/open-code-review/blob/main/internal/tool/definitions.go"
click node_comment_positioning "https://github.com/neshaki091/open-code-review/blob/main/internal/diff/resolver.go"
click node_llm_client "https://github.com/neshaki091/open-code-review/blob/main/internal/llm/client.go"
click node_mcp "https://github.com/neshaki091/open-code-review/blob/main/internal/mcp/client.go"
click node_config "https://github.com/neshaki091/open-code-review/blob/main/internal/config/template/template.go"
click node_session_store "https://github.com/neshaki091/open-code-review/blob/main/internal/session/persist.go"
click node_vscode_ui "https://github.com/neshaki091/open-code-review/blob/main/extensions/vscode/src/webview/App.tsx"
click node_vscode_session "https://github.com/neshaki091/open-code-review/blob/main/extensions/vscode/src/extension/services/ReviewSession.ts"
click node_cli_service "https://github.com/neshaki091/open-code-review/blob/main/extensions/vscode/src/extension/services/CliService.ts"
click node_config_ui "https://github.com/neshaki091/open-code-review/blob/main/extensions/vscode/src/webview/components/CustomProviderManager.tsx"
click node_config_utils "https://github.com/neshaki091/open-code-review/blob/main/extensions/vscode/src/shared/configUtils.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli_entry,node_review_cmd,node_scan_cmd toneBlue
class node_diff,node_agent,node_selection,node_scan_agent,node_llm_loop,node_review_tools,node_comment_positioning toneAmber
class node_llm_client,node_mcp,node_config,node_session_store toneMint
class node_vscode_ui,node_vscode_session,node_cli_service,node_config_ui,node_config_utils toneRose
class node_developer,node_model_service toneIndigo
```

## Components

### CLI and commands

- [CLI entry](https://github.com/neshaki091/open-code-review/blob/main/cmd/opencodereview/main.go): `cmd/opencodereview/main.go`
- [Diff review](https://github.com/neshaki091/open-code-review/blob/main/cmd/opencodereview/review_cmd.go): `cmd/opencodereview/review_cmd.go`
- [Whole-file scan](https://github.com/neshaki091/open-code-review/blob/main/cmd/opencodereview/scan_cmd.go): `cmd/opencodereview/scan_cmd.go`

### Review runtime

- [Git diff input](https://github.com/neshaki091/open-code-review/blob/main/internal/diff/parser.go): `internal/diff/parser.go`
- [Review agent](https://github.com/neshaki091/open-code-review/blob/main/internal/agent/agent.go): `internal/agent/agent.go`
- [File selection](https://github.com/neshaki091/open-code-review/blob/main/internal/agent/selection.go): `internal/agent/selection.go`
- [Scan agent](https://github.com/neshaki091/open-code-review/blob/main/internal/scan/agent.go): `internal/scan/agent.go`
- [Agent loop](https://github.com/neshaki091/open-code-review/blob/main/internal/llmloop/loop.go): `internal/llmloop/loop.go`
- [Review tools](https://github.com/neshaki091/open-code-review/blob/main/internal/tool/definitions.go): `internal/tool/definitions.go`
- [Comment positioning](https://github.com/neshaki091/open-code-review/blob/main/internal/diff/resolver.go): `internal/diff/resolver.go`

### Integrations and state

- [LLM client](https://github.com/neshaki091/open-code-review/blob/main/internal/llm/client.go): `internal/llm/client.go`
- [MCP integration](https://github.com/neshaki091/open-code-review/blob/main/internal/mcp/client.go): `internal/mcp/client.go`
- [Review rules](https://github.com/neshaki091/open-code-review/blob/main/internal/config/template/template.go): `internal/config/template/template.go`
- [Review sessions](https://github.com/neshaki091/open-code-review/blob/main/internal/session/persist.go): `internal/session/persist.go`

### VS Code extension

- [Review webview](https://github.com/neshaki091/open-code-review/blob/main/extensions/vscode/src/webview/App.tsx): `extensions/vscode/src/webview/App.tsx`
- [Extension session](https://github.com/neshaki091/open-code-review/blob/main/extensions/vscode/src/extension/services/ReviewSession.ts): `extensions/vscode/src/extension/services/ReviewSession.ts`
- [CLI service](https://github.com/neshaki091/open-code-review/blob/main/extensions/vscode/src/extension/services/CliService.ts): `extensions/vscode/src/extension/services/CliService.ts`
- [Provider settings UI](https://github.com/neshaki091/open-code-review/blob/main/extensions/vscode/src/webview/components/CustomProviderManager.tsx): `extensions/vscode/src/webview/components/CustomProviderManager.tsx`
- [Config utilities](https://github.com/neshaki091/open-code-review/blob/main/extensions/vscode/src/shared/configUtils.ts): `extensions/vscode/src/shared/configUtils.ts`

### Other components

- **Developer**
- **LLM provider**

## Connections

- Developer → CLI entry: runs (evidence: `README.md`)
- CLI entry → Diff review: dispatches
- Developer → Whole-file scan: requests scan (evidence: `README.md`)
- Diff review → Review agent: runs review (evidence: `cmd/opencodereview/review_cmd.go`)
- Diff review → Git diff input: loads changes (evidence: `README.md`)
- Review agent → File selection: selects files
- Review agent → Agent loop: runs agent (evidence: `README.md`)
- Agent loop → LLM client: requests completions (evidence: `internal/llmloop/loop.go`)
- LLM client → LLM provider: sends prompts (evidence: `README.md`)
- Agent loop → Review tools: dispatches tools (evidence: `internal/llmloop/loop.go`)
- Diff review → MCP integration: registers tools (evidence: `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 (evidence: `README.md`)
- Review webview → Extension session: starts session
- Extension session → CLI service: runs CLI (evidence: `extensions/vscode/src/extension/services/ReviewSession.ts`)
- CLI service → Diff review: invokes review
- Review webview → Provider settings UI: opens settings (evidence: `extensions/vscode/src/webview/App.tsx`)
- Provider settings UI → Config utilities: lists providers (evidence: `extensions/vscode/src/webview/components/CustomProviderManager.tsx`)
- Diff review → Review rules: uses review rules
