# krixx1337/reagentlive architecture

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

- Interactive diagram: https://gitdiagram.com/krixx1337/reagentlive
- Repository: https://github.com/krixx1337/reagentlive

## Overview

ReAgentLive is an in-process Windows runtime inspection agent exposed to AI tools and a CLI. The main workflow is an agent request through a frontend, the typed client/agent protocol, live process inspection, and structured results returned to the caller. Unreal support adds reflected object discovery and field access; the CLI also offers native memory and code queries. The README documents MCP setup and safety capabilities, but sampled source does not show the full agent dispatch or all frontend wiring, so those links are omitted where unverified.

Main entry points: [`src/reagentlive/frontends/cli/console/console.cpp`](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/console/console.cpp) (CLI Console), [`src/reagentlive/ue/agent_ue.cpp`](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/ue/agent_ue.cpp) (Unreal Agent), [`src/reagentlive/core/client.h`](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/core/client.h) (Typed Client), [`src/reagentlive/frontends/mcp/reagentlive_mcp.py`](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/mcp/reagentlive_mcp.py) (MCP Server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontends["User Frontends"]
  node_mcp["MCP Server<br/>[reagentlive_mcp.py]"]
  node_python_session["Python Session"]
  node_python_gen["Tool Generation<br/>[reagentlive_gen.py]"]
end

subgraph group_cli["CLI Workflow"]
  node_cli_console["CLI Console<br/>[console.cpp]"]
  node_cli_syntax["Command Parsing<br/>[parse.cpp]"]
  node_cli_native["Native Queries<br/>[memory.cpp]"]
  node_cli_code["Code Analysis<br/>[code_json.h]"]
  node_cli_ue["Unreal Commands<br/>[query.cpp]"]
  node_cli_results["Result Encoding<br/>[result_json.h]"]
  node_cli_state["CLI Session State<br/>[cache.h]"]
end

subgraph group_transport["Agent Transport"]
  node_core_client["Typed Client<br/>[client.h]"]
  node_core_protocol["Shared Protocol<br/>[protocol.h]"]
  node_core_agent["In-Process Agent<br/>[agent.cpp]"]
end

subgraph group_unreal["Unreal Inspection"]
  node_unreal_agent["Unreal Agent<br/>[agent_ue.cpp]"]
  node_unreal_client["Unreal Client API<br/>[client_ue.h]"]
  node_unreal_reflection["Reflection &amp; Scanning"]
  node_unreal_scan["Unreal Scanning<br/>[agent_ue_scan.cpp]"]
  node_unreal_values["Reflected Values<br/>[json_output.h]"]
end

node_agent_user(("AI Agent"))
node_target_process["Running Game"]

node_agent_user -->|"requests tools"| node_mcp
node_mcp -->|"uses session"| node_python_session
node_mcp -->|"uses tools"| node_python_gen
node_cli_console -->|"parses commands"| node_cli_syntax
node_cli_console -->|"calls API"| node_core_client
node_cli_console -->|"dispatches queries"| node_cli_native
node_cli_console -->|"dispatches analysis"| node_cli_code
node_cli_console -->|"dispatches Unreal"| node_cli_ue
node_cli_ue -->|"calls API"| node_unreal_client
node_cli_ue -->|"formats values"| node_unreal_values
node_cli_console -->|"encodes results"| node_cli_results
node_cli_console -->|"uses cached state"| node_cli_state
node_core_client -->|"uses definitions"| node_core_protocol
node_core_client -.->|"requests agent"| node_core_agent
node_core_agent -->|"inspects live state"| node_target_process
node_unreal_client -->|"uses transport"| node_core_client
node_unreal_agent -.->|"extends agent"| node_core_agent
node_unreal_agent -.->|"uses reflection"| node_unreal_reflection
node_unreal_agent -.->|"scans objects"| node_unreal_scan
node_unreal_agent -->|"inspects game"| node_target_process

click node_mcp "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/mcp/reagentlive_mcp.py"
click node_python_session "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/python/reagentlive_session.py"
click node_python_gen "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/python/reagentlive_gen.py"
click node_cli_console "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/console/console.cpp"
click node_cli_syntax "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/syntax/parse.cpp"
click node_cli_native "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/console/memory.cpp"
click node_cli_code "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/code/code_json.h"
click node_cli_ue "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/console/ue/query.cpp"
click node_cli_results "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/results/result_json.h"
click node_cli_state "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/state/cache.h"
click node_core_client "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/core/client.h"
click node_core_protocol "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/core/protocol.h"
click node_core_agent "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/core/agent.cpp"
click node_unreal_agent "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/ue/agent_ue.cpp"
click node_unreal_client "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/ue/client_ue.h"
click node_unreal_reflection "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/ue/agent_ue_reflect.cpp"
click node_unreal_scan "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/ue/agent_ue_scan.cpp"
click node_unreal_values "https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/values/ue/json_output.h"

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_python_session,node_python_gen toneBlue
class node_cli_console,node_cli_syntax,node_cli_native,node_cli_code,node_cli_ue,node_cli_results,node_cli_state toneAmber
class node_core_client,node_core_protocol,node_core_agent toneMint
class node_unreal_agent,node_unreal_client,node_unreal_reflection,node_unreal_scan,node_unreal_values toneRose
class node_agent_user,node_target_process toneIndigo
```

## Components

### User Frontends

- [MCP Server](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/mcp/reagentlive_mcp.py): `src/reagentlive/frontends/mcp/reagentlive_mcp.py`
- [Python Session](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/python/reagentlive_session.py): `src/reagentlive/frontends/python/reagentlive_session.py`
- [Tool Generation](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/python/reagentlive_gen.py): `src/reagentlive/frontends/python/reagentlive_gen.py`

### CLI Workflow

- [CLI Console](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/console/console.cpp): `src/reagentlive/frontends/cli/console/console.cpp`
- [Command Parsing](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/syntax/parse.cpp): `src/reagentlive/frontends/cli/syntax/parse.cpp`
- [Native Queries](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/console/memory.cpp): `src/reagentlive/frontends/cli/console/memory.cpp`
- [Code Analysis](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/code/code_json.h): `src/reagentlive/frontends/cli/code/code_json.h`
- [Unreal Commands](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/console/ue/query.cpp): `src/reagentlive/frontends/cli/console/ue/query.cpp`
- [Result Encoding](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/results/result_json.h): `src/reagentlive/frontends/cli/results/result_json.h`
- [CLI Session State](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/state/cache.h): `src/reagentlive/frontends/cli/state/cache.h`

### Agent Transport

- [Typed Client](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/core/client.h): `src/reagentlive/core/client.h`
- [Shared Protocol](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/core/protocol.h): `src/reagentlive/core/protocol.h`
- [In-Process Agent](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/core/agent.cpp): `src/reagentlive/core/agent.cpp`

### Unreal Inspection

- [Unreal Agent](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/ue/agent_ue.cpp): `src/reagentlive/ue/agent_ue.cpp`
- [Unreal Client API](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/ue/client_ue.h): `src/reagentlive/ue/client_ue.h`
- [Reflection & Scanning](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/ue/agent_ue_reflect.cpp): `src/reagentlive/ue/agent_ue_reflect.cpp`
- [Unreal Scanning](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/ue/agent_ue_scan.cpp): `src/reagentlive/ue/agent_ue_scan.cpp`
- [Reflected Values](https://github.com/krixx1337/reagentlive/blob/main/src/reagentlive/frontends/cli/values/ue/json_output.h): `src/reagentlive/frontends/cli/values/ue/json_output.h`

### Other components

- **AI Agent**
- **Running Game**

## Connections

- AI Agent → MCP Server: requests tools (evidence: `README.md`)
- MCP Server → Python Session: uses session (evidence: `src/reagentlive/frontends/mcp/reagentlive_mcp.py`)
- MCP Server → Tool Generation: uses tools (evidence: `src/reagentlive/frontends/mcp/reagentlive_mcp.py`)
- CLI Console → Command Parsing: parses commands (evidence: `src/reagentlive/frontends/cli/console/console.cpp`)
- CLI Console → Typed Client: calls API (evidence: `src/reagentlive/frontends/cli/console/console.cpp`)
- CLI Console → Native Queries: dispatches queries (evidence: `src/reagentlive/frontends/cli/console/console.cpp`)
- CLI Console → Code Analysis: dispatches analysis (evidence: `src/reagentlive/frontends/cli/console/console.cpp`)
- CLI Console → Unreal Commands: dispatches Unreal (evidence: `src/reagentlive/frontends/cli/console/console.cpp`)
- Unreal Commands → Unreal Client API: calls API (evidence: `src/reagentlive/frontends/cli/console/ue/query.cpp`)
- Unreal Commands → Reflected Values: formats values (evidence: `src/reagentlive/frontends/cli/console/ue/query.cpp`)
- CLI Console → Result Encoding: encodes results
- CLI Console → CLI Session State: uses cached state (evidence: `src/reagentlive/frontends/cli/console/console.cpp`)
- Typed Client → Shared Protocol: uses definitions (evidence: `src/reagentlive/core/client.h`)
- Typed Client → In-Process Agent: requests agent
- In-Process Agent → Running Game: inspects live state (evidence: `README.md`)
- Unreal Client API → Typed Client: uses transport (evidence: `src/reagentlive/ue/client_ue.h`)
- Unreal Agent → In-Process Agent: extends agent
- Unreal Agent → Reflection & Scanning: uses reflection
- Unreal Agent → Unreal Scanning: scans objects
- Unreal Agent → Running Game: inspects game (evidence: `README.md`)