# mrdevmohamed/rdx architecture

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

- Interactive diagram: https://gitdiagram.com/mrdevmohamed/rdx
- Repository: https://github.com/mrdevmohamed/rdx

## Overview

RDX is a desktop Android reverse-engineering and code-review tool with CLI and MCP access. Its main workflow opens an APK, split package, or DEX; reads package and DEX metadata; reconstructs Java where supported; and lets users inspect code, search, and follow relationships. Manifest and resource inspection, exports, and agent access are additional product capabilities. The graph combines README-documented workflows with relationships visible in the supplied source index and excerpts; unsampled implementation details are represented only at supported directory or module paths.

Main entry points: [`src/engine.rs`](https://github.com/mrdevmohamed/rdx/blob/main/src/engine.rs) (Project engine), [`src/native_engine.rs`](https://github.com/mrdevmohamed/rdx/blob/main/src/native_engine.rs) (Native DEX engine), [`src/package_container.rs`](https://github.com/mrdevmohamed/rdx/blob/main/src/package_container.rs) (Package container), [`src/native_java/method.rs`](https://github.com/mrdevmohamed/rdx/blob/main/src/native_java/method.rs) (Java reconstruction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Package input"]
  node_container["Package container"]
  node_apk["APK handling<br/>[apk.rs]"]
end

subgraph group_analysis["DEX analysis"]
  node_dex["DEX reader<br/>[native_dex.rs]"]
  node_engine["Project engine<br/>[engine.rs]"]
  node_native["Native DEX engine<br/>[native_engine.rs]"]
  node_ir["Instruction decoding<br/>[native_ir.rs]"]
  node_hierarchy["Type hierarchy"]
  node_java["Java reconstruction<br/>[method.rs]"]
  node_names["Java display names<br/>[names.rs]"]
end

subgraph group_investigation["Code investigation"]
  node_resources["Resource inspection"]
  node_resource_table[("Resource table<br/>[resource_table.rs]")]
  node_manifest["Manifest inspection"]
  node_search["Project search<br/>[search.rs]"]
  node_search_index[("Search index<br/>[search_index.rs]")]
  node_usages["Usage lookup<br/>[usages.rs]"]
  node_callgraph["Call graph<br/>[call_graph.rs]"]
  node_export["File export<br/>[export.rs]"]
end

subgraph group_interfaces["User interfaces"]
  node_code["Code viewer<br/>[code_view.rs]"]
  node_navigation["Code navigation<br/>[navigation.rs]"]
  node_gui["Desktop interface<br/>[ui.rs]"]
end

subgraph group_integration["Agent access"]
  node_mcp["MCP server<br/>[mcp.rs]"]
end

node_user(("Engineer"))
node_app["Android package"]
node_assistant(("MCP assistant"))

node_user -->|"selects"| node_app
node_app -->|"opens"| node_container
node_container -->|"unpacks"| node_apk
node_container -->|"provides DEX inputs"| node_native
node_native -->|"parses"| node_dex
node_engine -->|"delegates"| node_native
node_native -->|"reconstructs"| node_java
node_native -->|"consults"| node_hierarchy
node_java -->|"uses"| node_names
node_java -->|"decodes"| node_ir
node_user -->|"inspects"| node_gui
node_gui -->|"shows"| node_code
node_engine -->|"supplies reconstructed code"| node_code
node_code -->|"supports jumps"| node_navigation
node_user -->|"searches"| node_search
node_search -->|"loads source"| node_engine
node_search -->|"uses index"| node_search_index
node_user -->|"inspects"| node_manifest
node_engine -->|"reads resources"| node_resources
node_engine -->|"consults"| node_resource_table
node_user -->|"traces declarations"| node_usages
node_user -->|"follows calls"| node_callgraph
node_user -->|"exports files"| node_export
node_assistant -->|"requests inspection"| node_mcp
node_mcp -->|"inspects project"| node_engine

click node_container "https://github.com/mrdevmohamed/rdx/blob/main/src/package_container.rs"
click node_apk "https://github.com/mrdevmohamed/rdx/blob/main/src/apk.rs"
click node_dex "https://github.com/mrdevmohamed/rdx/blob/main/src/native_dex.rs"
click node_engine "https://github.com/mrdevmohamed/rdx/blob/main/src/engine.rs"
click node_native "https://github.com/mrdevmohamed/rdx/blob/main/src/native_engine.rs"
click node_ir "https://github.com/mrdevmohamed/rdx/blob/main/src/native_ir.rs"
click node_hierarchy "https://github.com/mrdevmohamed/rdx/blob/main/src/native_hierarchy.rs"
click node_java "https://github.com/mrdevmohamed/rdx/blob/main/src/native_java/method.rs"
click node_names "https://github.com/mrdevmohamed/rdx/blob/main/src/native_java/names.rs"
click node_resources "https://github.com/mrdevmohamed/rdx/blob/main/src/native_resources.rs"
click node_resource_table "https://github.com/mrdevmohamed/rdx/blob/main/src/resource_table.rs"
click node_manifest "https://github.com/mrdevmohamed/rdx/blob/main/src/manifest_summary.rs"
click node_code "https://github.com/mrdevmohamed/rdx/blob/main/src/code_view.rs"
click node_navigation "https://github.com/mrdevmohamed/rdx/blob/main/src/navigation.rs"
click node_search "https://github.com/mrdevmohamed/rdx/blob/main/src/search.rs"
click node_search_index "https://github.com/mrdevmohamed/rdx/blob/main/src/search_index.rs"
click node_usages "https://github.com/mrdevmohamed/rdx/blob/main/src/usages.rs"
click node_callgraph "https://github.com/mrdevmohamed/rdx/blob/main/src/call_graph.rs"
click node_export "https://github.com/mrdevmohamed/rdx/blob/main/src/export.rs"
click node_gui "https://github.com/mrdevmohamed/rdx/blob/main/src/ui.rs"
click node_mcp "https://github.com/mrdevmohamed/rdx/blob/main/src/mcp.rs"

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_container,node_apk toneBlue
class node_dex,node_engine,node_native,node_ir,node_hierarchy,node_java,node_names toneAmber
class node_resources,node_resource_table,node_manifest,node_search,node_search_index,node_usages,node_callgraph,node_export toneMint
class node_code,node_navigation,node_gui toneRose
class node_mcp,node_user,node_app,node_assistant toneIndigo
```

## Components

### Package input

- [Package container](https://github.com/mrdevmohamed/rdx/blob/main/src/package_container.rs): `src/package_container.rs`
- [APK handling](https://github.com/mrdevmohamed/rdx/blob/main/src/apk.rs): `src/apk.rs`

### DEX analysis

- [DEX reader](https://github.com/mrdevmohamed/rdx/blob/main/src/native_dex.rs): `src/native_dex.rs`
- [Project engine](https://github.com/mrdevmohamed/rdx/blob/main/src/engine.rs): `src/engine.rs`
- [Native DEX engine](https://github.com/mrdevmohamed/rdx/blob/main/src/native_engine.rs): `src/native_engine.rs`
- [Instruction decoding](https://github.com/mrdevmohamed/rdx/blob/main/src/native_ir.rs): `src/native_ir.rs`
- [Type hierarchy](https://github.com/mrdevmohamed/rdx/blob/main/src/native_hierarchy.rs): `src/native_hierarchy.rs`
- [Java reconstruction](https://github.com/mrdevmohamed/rdx/blob/main/src/native_java/method.rs): `src/native_java/method.rs`
- [Java display names](https://github.com/mrdevmohamed/rdx/blob/main/src/native_java/names.rs): `src/native_java/names.rs`

### Code investigation

- [Resource inspection](https://github.com/mrdevmohamed/rdx/blob/main/src/native_resources.rs): `src/native_resources.rs`
- [Resource table](https://github.com/mrdevmohamed/rdx/blob/main/src/resource_table.rs): `src/resource_table.rs`
- [Manifest inspection](https://github.com/mrdevmohamed/rdx/blob/main/src/manifest_summary.rs): `src/manifest_summary.rs`
- [Project search](https://github.com/mrdevmohamed/rdx/blob/main/src/search.rs): `src/search.rs`
- [Search index](https://github.com/mrdevmohamed/rdx/blob/main/src/search_index.rs): `src/search_index.rs`
- [Usage lookup](https://github.com/mrdevmohamed/rdx/blob/main/src/usages.rs): `src/usages.rs`
- [Call graph](https://github.com/mrdevmohamed/rdx/blob/main/src/call_graph.rs): `src/call_graph.rs`
- [File export](https://github.com/mrdevmohamed/rdx/blob/main/src/export.rs): `src/export.rs`

### User interfaces

- [Code viewer](https://github.com/mrdevmohamed/rdx/blob/main/src/code_view.rs): `src/code_view.rs`
- [Code navigation](https://github.com/mrdevmohamed/rdx/blob/main/src/navigation.rs): `src/navigation.rs`
- [Desktop interface](https://github.com/mrdevmohamed/rdx/blob/main/src/ui.rs): `src/ui.rs`

### Agent access

- [MCP server](https://github.com/mrdevmohamed/rdx/blob/main/src/mcp.rs): `src/mcp.rs`

### Other components

- **Engineer**
- **Android package**
- **MCP assistant**

## Connections

- Engineer → Android package: selects
- Android package → Package container: opens
- Package container → APK handling: unpacks (evidence: `src/package_container.rs`)
- Package container → Native DEX engine: provides DEX inputs (evidence: `src/native_engine.rs`)
- Native DEX engine → DEX reader: parses (evidence: `src/native_engine.rs`)
- Project engine → Native DEX engine: delegates (evidence: `src/engine.rs`)
- Native DEX engine → Java reconstruction: reconstructs (evidence: `src/native_engine.rs`)
- Native DEX engine → Type hierarchy: consults (evidence: `src/native_engine.rs`)
- Java reconstruction → Java display names: uses
- Java reconstruction → Instruction decoding: decodes
- Engineer → Desktop interface: inspects
- Desktop interface → Code viewer: shows (evidence: `src/main.rs`)
- Project engine → Code viewer: supplies reconstructed code
- Code viewer → Code navigation: supports jumps
- Engineer → Project search: searches
- Project search → Project engine: loads source (evidence: `src/search.rs`)
- Project search → Search index: uses index (evidence: `src/search.rs`)
- Engineer → Manifest inspection: inspects
- Project engine → Resource inspection: reads resources (evidence: `src/engine.rs`)
- Project engine → Resource table: consults (evidence: `src/engine.rs`)
- Engineer → Usage lookup: traces declarations
- Engineer → Call graph: follows calls
- Engineer → File export: exports files
- MCP assistant → MCP server: requests inspection
- MCP server → Project engine: inspects project
