# mritunjaysingh04/rea-reverse-engineer-anything-with-bots architecture

> Architecture diagram of the GitHub repository mritunjaysingh04/rea-reverse-engineer-anything-with-bots, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots
- Repository: https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots

## Overview

REA is a local reverse-engineering MCP server with a CLI sharing its analysis workflows. An agent or terminal user selects a target and asks REA to inspect or trace it; REA routes work to target-specific analysis engines and returns findings with evidence and limitations. The map preserves the documented native, application, browser, Android, firmware, and binary-diagnostics capabilities. Some subsystem paths are directories because their implementation files were not sampled; relationships without direct source or README evidence are omitted.

Main entry points: [`src/application/reverse/ReverseEngineeringService.ts`](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/application/reverse/ReverseEngineeringService.ts) (Reverse analysis), [`src/main.ts`](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/main.ts) (MCP server), [`src/server/registerReverseEngineeringTools.ts`](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/server/registerReverseEngineeringTools.ts) (MCP tool routes), [`src/cli/reverseEngineeringCommands.ts`](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/cli/reverseEngineeringCommands.ts) (CLI commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry points"]
  node_mcp["MCP server<br/>[main.ts]"]
  node_toolroutes["MCP tool routes"]
  node_cli["CLI commands"]
end

subgraph group_workflow["Analysis workflow"]
  node_orchestrator["Reverse analysis"]
  node_composition["Provider composition"]
  node_contracts["Analysis contracts"]
end

subgraph group_providers["Analysis providers"]
  node_nativeproviders["Native providers"]
  node_hopper["Hopper provider<br/>[HopperClient.ts]"]
  node_ida["IDA provider"]
  node_debuggers["Debugger sessions"]
  node_rizin["Rizin debugger"]
  node_cutter["Cutter bridge"]
end

subgraph group_capabilities["Target capabilities"]
  node_binarydiag["Binary diagnostics"]
  node_javascript["JavaScript analysis"]
  node_browser["Browser observation"]
  node_android["Android analysis"]
  node_firmware["Firmware analysis"]
end

subgraph group_evidence["Evidence and results"]
  node_evidence["Evidence model<br/>[evidence.ts]"]
  node_errors["Typed analysis errors"]
end

node_agent(("AI agent"))
node_terminal(("Terminal user"))
node_targets["Local target"]

node_agent -->|"asks via MCP"| node_mcp
node_terminal -->|"runs workflows"| node_cli
node_mcp -->|"registers tools"| node_toolroutes
node_toolroutes -->|"invokes"| node_orchestrator
node_cli -->|"creates service"| node_orchestrator
node_orchestrator -->|"uses commands"| node_composition
node_orchestrator -->|"validates inputs"| node_contracts
node_targets -->|"supplies target"| node_orchestrator
node_orchestrator -->|"retains findings"| node_evidence
node_orchestrator -->|"reports failures"| node_errors
node_composition -.->|"selects provider"| node_nativeproviders
node_orchestrator -.->|"analyzes layout"| node_binarydiag
node_orchestrator -.->|"analyzes app"| node_javascript
node_orchestrator -.->|"observes runtime"| node_browser
node_orchestrator -.->|"analyzes package"| node_android
node_orchestrator -.->|"analyzes firmware"| node_firmware
node_nativeproviders -->|"inspects binaries"| node_targets
node_hopper -->|"inspects binaries"| node_targets
node_ida -->|"inspects binaries"| node_targets
node_debuggers -.->|"debugs target"| node_targets
node_rizin -.->|"debugs target"| node_targets
node_cutter -.->|"analyzes binary"| node_targets

click node_mcp "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/main.ts"
click node_toolroutes "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/server/registerReverseEngineeringTools.ts"
click node_cli "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/cli/reverseEngineeringCommands.ts"
click node_orchestrator "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/application/reverse/ReverseEngineeringService.ts"
click node_composition "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/composition/reverseEngineering.ts"
click node_contracts "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/domain/reverseEngineering.ts"
click node_nativeproviders "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/ghidra/GhidraProviderClient.ts"
click node_hopper "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/hopper/HopperClient.ts"
click node_ida "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/ida/IdaSessionClient.ts"
click node_debuggers "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/gdb/GdbSessionManager.ts"
click node_rizin "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/rizin/RizinDebugSessionManager.ts"
click node_cutter "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/cutter/CutterBridgeClient.ts"
click node_binarydiag "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/tree/main/src/application/binaryDiagnostics"
click node_javascript "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/javascript/analysis/JavaScriptAnalysisWorker.ts"
click node_browser "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/tree/main/src/browser"
click node_android "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/tree/main/src/application/android"
click node_firmware "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/tree/main/src/application/firmware"
click node_evidence "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/domain/evidence.ts"
click node_errors "https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/domain/analysisErrorBase.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_mcp,node_toolroutes,node_cli,node_terminal toneBlue
class node_orchestrator,node_composition,node_contracts toneAmber
class node_nativeproviders,node_hopper,node_ida,node_debuggers,node_rizin,node_cutter toneMint
class node_binarydiag,node_javascript,node_browser,node_android,node_firmware toneRose
class node_evidence,node_errors,node_agent,node_targets toneIndigo
```

## Components

### Entry points

- [MCP server](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/main.ts): `src/main.ts`
- [MCP tool routes](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/server/registerReverseEngineeringTools.ts): `src/server/registerReverseEngineeringTools.ts`
- [CLI commands](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/cli/reverseEngineeringCommands.ts): `src/cli/reverseEngineeringCommands.ts`

### Analysis workflow

- [Reverse analysis](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/application/reverse/ReverseEngineeringService.ts): `src/application/reverse/ReverseEngineeringService.ts`
- [Provider composition](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/composition/reverseEngineering.ts): `src/composition/reverseEngineering.ts`
- [Analysis contracts](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/domain/reverseEngineering.ts): `src/domain/reverseEngineering.ts`

### Analysis providers

- [Native providers](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/ghidra/GhidraProviderClient.ts): `src/ghidra/GhidraProviderClient.ts`
- [Hopper provider](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/hopper/HopperClient.ts): `src/hopper/HopperClient.ts`
- [IDA provider](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/ida/IdaSessionClient.ts): `src/ida/IdaSessionClient.ts`
- [Debugger sessions](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/gdb/GdbSessionManager.ts): `src/gdb/GdbSessionManager.ts`
- [Rizin debugger](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/rizin/RizinDebugSessionManager.ts): `src/rizin/RizinDebugSessionManager.ts`
- [Cutter bridge](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/cutter/CutterBridgeClient.ts): `src/cutter/CutterBridgeClient.ts`

### Target capabilities

- [Binary diagnostics](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/tree/main/src/application/binaryDiagnostics): `src/application/binaryDiagnostics`
- [JavaScript analysis](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/javascript/analysis/JavaScriptAnalysisWorker.ts): `src/javascript/analysis/JavaScriptAnalysisWorker.ts`
- [Browser observation](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/tree/main/src/browser): `src/browser`
- [Android analysis](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/tree/main/src/application/android): `src/application/android`
- [Firmware analysis](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/tree/main/src/application/firmware): `src/application/firmware`

### Evidence and results

- [Evidence model](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/domain/evidence.ts): `src/domain/evidence.ts`
- [Typed analysis errors](https://github.com/mritunjaysingh04/rea-reverse-engineer-anything-with-bots/blob/main/src/domain/analysisErrorBase.ts): `src/domain/analysisErrorBase.ts`

### Other components

- **AI agent**
- **Terminal user**
- **Local target**

## Connections

- AI agent → MCP server: asks via MCP (evidence: `README.md`)
- Terminal user → CLI commands: runs workflows (evidence: `README.md`)
- MCP server → MCP tool routes: registers tools (evidence: `src/server/registerReverseEngineeringTools.ts`)
- MCP tool routes → Reverse analysis: invokes (evidence: `src/server/registerReverseEngineeringTools.ts`)
- CLI commands → Reverse analysis: creates service (evidence: `src/cli/reverseEngineeringCommands.ts`)
- Reverse analysis → Provider composition: uses commands (evidence: `src/composition/reverseEngineering.ts`)
- Reverse analysis → Analysis contracts: validates inputs (evidence: `src/application/reverse/ReverseEngineeringService.ts`)
- Local target → Reverse analysis: supplies target (evidence: `README.md`)
- Reverse analysis → Evidence model: retains findings (evidence: `src/domain/evidence.ts`)
- Reverse analysis → Typed analysis errors: reports failures (evidence: `src/application/reverse/ReverseEngineeringService.ts`)
- Provider composition → Native providers: selects provider
- Reverse analysis → Binary diagnostics: analyzes layout
- Reverse analysis → JavaScript analysis: analyzes app
- Reverse analysis → Browser observation: observes runtime
- Reverse analysis → Android analysis: analyzes package
- Reverse analysis → Firmware analysis: analyzes firmware
- Native providers → Local target: inspects binaries (evidence: `README.md`)
- Hopper provider → Local target: inspects binaries (evidence: `README.md`)
- IDA provider → Local target: inspects binaries (evidence: `README.md`)
- Debugger sessions → Local target: debugs target
- Rizin debugger → Local target: debugs target
- Cutter bridge → Local target: analyzes binary
