# laachreef/ai-code-reviewer architecture

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

- Interactive diagram: https://gitdiagram.com/laachreef/ai-code-reviewer
- Repository: https://github.com/laachreef/ai-code-reviewer

## Overview

AI Code Reviewer is an Electron desktop app for reviewing local changes and GitHub/GitLab pull or merge requests with configurable multi-agent AI analysis. The principal workflow runs from the dashboard through Electron’s review handler, which obtains a diff and invokes the agent engine; results can be inspected, posted as comments, and retained in history. The graph also preserves repository management, configuration, webhook notifications, and UI configuration capabilities. Some IPC handlers and UI behavior were not excerpted, so uncertain links are omitted.

Main entry points: [`src/components/Dashboard.tsx`](https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/Dashboard.tsx) (Review dashboard), [`electron/main.ts`](https://github.com/laachreef/ai-code-reviewer/blob/main/electron/main.ts) (IPC and review handler), [`src/components/Modal.tsx`](https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/Modal.tsx) (Modal frame), [`src/components/ReviewReport.tsx`](https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/ReviewReport.tsx) (Review report)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Review interface"]
  node_app["App shell<br/>[App.tsx]"]
  node_dashboard["Review dashboard<br/>[Dashboard.tsx]"]
  node_report["Review report<br/>[ReviewReport.tsx]"]
  node_agent_ui["Agent settings<br/>[AgentManager.tsx]"]
  node_analysis_ui["Analysis settings"]
  node_config_ui["App settings<br/>[ConfigModal.tsx]"]
  node_provider_ui["Custom providers"]
  node_history_ui["History view<br/>[HistoryModal.tsx]"]
  node_about_ui["About view<br/>[AboutModal.tsx]"]
  node_modal["Modal frame<br/>[Modal.tsx]"]
end

subgraph group_runtime["Review runtime"]
  node_electron["IPC and review handler<br/>[main.ts]"]
  node_agents["Multi-agent analysis<br/>[agents.ts]"]
end

subgraph group_integrations["External integrations"]
  node_git["Remote Git manager<br/>[gitClients.ts]"]
  node_local_git["Local Git manager<br/>[localGit.ts]"]
  node_webhook["PR webhook listener<br/>[webhook.ts]"]
end

subgraph group_state["Configuration and history"]
  node_state_store[("Config and history store<br/>[store.ts]")]
end

node_user(("Reviewer"))
node_git_service["GitHub / GitLab"]
node_ai_service["AI providers"]
node_local_repo["Local repository"]

node_user -->|"selects review"| node_dashboard
node_app -->|"renders"| node_dashboard
node_app -->|"renders"| node_report
node_dashboard -->|"requests review"| node_electron
node_electron -->|"fetches remote diff"| node_git
node_electron -->|"fetches local diff"| node_local_git
node_electron -->|"runs analysis"| node_agents
node_electron -->|"loads and saves"| node_state_store
node_electron -->|"starts listener"| node_webhook
node_git -->|"reads and posts"| node_git_service
node_local_git -->|"reads diff"| node_local_repo
node_agents -->|"calls models"| node_ai_service
node_webhook -->|"notifies PR"| node_dashboard
node_report -->|"posts review"| node_electron
node_report -->|"saves history"| node_state_store
node_dashboard -->|"opens settings"| node_agent_ui
node_dashboard -->|"opens settings"| node_analysis_ui
node_dashboard -->|"opens history"| node_history_ui
node_dashboard -->|"opens about"| node_about_ui
node_dashboard -->|"opens settings"| node_config_ui
node_config_ui -->|"opens provider setup"| node_provider_ui
node_agent_ui -->|"renders in"| node_modal
node_provider_ui -->|"renders in"| node_modal
node_config_ui -->|"renders in"| node_modal
node_history_ui -->|"renders in"| node_modal
node_about_ui -->|"renders in"| node_modal

click node_app "https://github.com/laachreef/ai-code-reviewer/blob/main/src/App.tsx"
click node_dashboard "https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/Dashboard.tsx"
click node_report "https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/ReviewReport.tsx"
click node_agent_ui "https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/AgentManager.tsx"
click node_analysis_ui "https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/AnalysisConfigModal.tsx"
click node_config_ui "https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/ConfigModal.tsx"
click node_provider_ui "https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/CustomProviderModal.tsx"
click node_history_ui "https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/HistoryModal.tsx"
click node_about_ui "https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/AboutModal.tsx"
click node_modal "https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/Modal.tsx"
click node_electron "https://github.com/laachreef/ai-code-reviewer/blob/main/electron/main.ts"
click node_agents "https://github.com/laachreef/ai-code-reviewer/blob/main/electron/agents.ts"
click node_git "https://github.com/laachreef/ai-code-reviewer/blob/main/electron/gitClients.ts"
click node_local_git "https://github.com/laachreef/ai-code-reviewer/blob/main/electron/localGit.ts"
click node_webhook "https://github.com/laachreef/ai-code-reviewer/blob/main/electron/webhook.ts"
click node_state_store "https://github.com/laachreef/ai-code-reviewer/blob/main/electron/store.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_app,node_dashboard,node_report,node_agent_ui,node_analysis_ui,node_config_ui,node_provider_ui,node_history_ui,node_about_ui,node_modal,node_user toneBlue
class node_electron,node_agents toneAmber
class node_git,node_local_git,node_webhook toneMint
class node_state_store toneRose
class node_git_service,node_ai_service,node_local_repo toneIndigo
```

## Components

### Review interface

- [App shell](https://github.com/laachreef/ai-code-reviewer/blob/main/src/App.tsx): `src/App.tsx`
- [Review dashboard](https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/Dashboard.tsx): `src/components/Dashboard.tsx`
- [Review report](https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/ReviewReport.tsx): `src/components/ReviewReport.tsx`
- [Agent settings](https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/AgentManager.tsx): `src/components/AgentManager.tsx`
- [Analysis settings](https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/AnalysisConfigModal.tsx): `src/components/AnalysisConfigModal.tsx`
- [App settings](https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/ConfigModal.tsx): `src/components/ConfigModal.tsx`
- [Custom providers](https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/CustomProviderModal.tsx): `src/components/CustomProviderModal.tsx`
- [History view](https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/HistoryModal.tsx): `src/components/HistoryModal.tsx`
- [About view](https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/AboutModal.tsx): `src/components/AboutModal.tsx`
- [Modal frame](https://github.com/laachreef/ai-code-reviewer/blob/main/src/components/Modal.tsx): `src/components/Modal.tsx`

### Review runtime

- [IPC and review handler](https://github.com/laachreef/ai-code-reviewer/blob/main/electron/main.ts): `electron/main.ts`
- [Multi-agent analysis](https://github.com/laachreef/ai-code-reviewer/blob/main/electron/agents.ts): `electron/agents.ts`

### External integrations

- [Remote Git manager](https://github.com/laachreef/ai-code-reviewer/blob/main/electron/gitClients.ts): `electron/gitClients.ts`
- [Local Git manager](https://github.com/laachreef/ai-code-reviewer/blob/main/electron/localGit.ts): `electron/localGit.ts`
- [PR webhook listener](https://github.com/laachreef/ai-code-reviewer/blob/main/electron/webhook.ts): `electron/webhook.ts`

### Configuration and history

- [Config and history store](https://github.com/laachreef/ai-code-reviewer/blob/main/electron/store.ts): `electron/store.ts`

### Other components

- **Reviewer**
- **GitHub / GitLab**
- **AI providers**
- **Local repository**

## Connections

- Reviewer → Review dashboard: selects review (evidence: `README.md`)
- App shell → Review dashboard: renders (evidence: `src/App.tsx`)
- App shell → Review report: renders (evidence: `src/App.tsx`)
- Review dashboard → IPC and review handler: requests review (evidence: `src/components/Dashboard.tsx`)
- IPC and review handler → Remote Git manager: fetches remote diff (evidence: `electron/main.ts`)
- IPC and review handler → Local Git manager: fetches local diff (evidence: `electron/main.ts`)
- IPC and review handler → Multi-agent analysis: runs analysis (evidence: `electron/main.ts`)
- IPC and review handler → Config and history store: loads and saves (evidence: `electron/main.ts`)
- IPC and review handler → PR webhook listener: starts listener (evidence: `electron/main.ts`)
- Remote Git manager → GitHub / GitLab: reads and posts (evidence: `electron/gitClients.ts`)
- Local Git manager → Local repository: reads diff (evidence: `electron/localGit.ts`)
- Multi-agent analysis → AI providers: calls models (evidence: `electron/agents.ts`)
- PR webhook listener → Review dashboard: notifies PR (evidence: `electron/webhook.ts`)
- Review report → IPC and review handler: posts review (evidence: `src/components/ReviewReport.tsx`)
- Review report → Config and history store: saves history (evidence: `src/components/ReviewReport.tsx`)
- Review dashboard → Agent settings: opens settings (evidence: `src/components/Dashboard.tsx`)
- Review dashboard → Analysis settings: opens settings (evidence: `src/components/Dashboard.tsx`)
- Review dashboard → History view: opens history (evidence: `src/components/Dashboard.tsx`)
- Review dashboard → About view: opens about (evidence: `src/components/Dashboard.tsx`)
- Review dashboard → App settings: opens settings (evidence: `src/components/Dashboard.tsx`)
- App settings → Custom providers: opens provider setup (evidence: `src/components/ConfigModal.tsx`)
- Agent settings → Modal frame: renders in (evidence: `src/components/AgentManager.tsx`)
- Custom providers → Modal frame: renders in (evidence: `src/components/CustomProviderModal.tsx`)
- App settings → Modal frame: renders in (evidence: `src/components/ConfigModal.tsx`)
- History view → Modal frame: renders in (evidence: `src/components/HistoryModal.tsx`)
- About view → Modal frame: renders in (evidence: `src/components/AboutModal.tsx`)
