# airaccelerate/cli-debugger architecture

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

- Interactive diagram: https://gitdiagram.com/airaccelerate/cli-debugger
- Repository: https://github.com/airaccelerate/cli-debugger

## Overview

cli-debugger is a native Windows command-line debugger for x64 and x86 processes. The main workflow is user commands or batch input → argument parsing → launch/attach → debugger event and command handling → inspection, execution control, or instrumentation of the target. The graph includes documented reverse-engineering features and the x86 disassembler. The excerpts and index establish the main entry points and several module references; feature-level links rely on README descriptions where implementation was not sampled.

Main entry points: [`cli-debugger/debugger/debugger_commands.cpp`](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_commands.cpp) (Command interpreter), [`cli-debugger/cli/argument_parser.cpp`](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/cli/argument_parser.cpp) (Argument parser), [`cli-debugger32/debugger/debugger_events.cpp`](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger32/debugger/debugger_events.cpp) (x86 debugger runtime), [`cli-debugger/main.cpp`](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/main.cpp) (x64 entry point)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["CLI interaction"]
  node_arguments["Argument parser"]
  node_x64main["x64 entry point<br/>[main.cpp]"]
  node_x86main["x86 entry point<br/>[main.cpp]"]
  node_command["Command interpreter"]
end

subgraph group_runtime["Debug runtime"]
  node_lifecycle["Launch and attach"]
  node_events["Event loop"]
  node_breakpoints["Breakpoints"]
  node_memory["Memory operations"]
  node_registers["Registers and context"]
end

subgraph group_analysis["Inspection and unpacking"]
  node_symbols["Symbols and modules"]
  node_inspection["Debug inspection<br/>[debugger_print.cpp]"]
  node_dump["Dump and rebuild<br/>[debugger_dump.cpp]"]
  node_pe["PE image support<br/>[pe_image.c]"]
  node_disasm64["x64 disassembler"]
end

subgraph group_instrumentation["Instrumentation and capture"]
  node_anti["API emulation and guards"]
  node_hooks["API hooks<br/>[debugger_hooks.cpp]"]
  node_network["Network capture<br/>[debugger_net.cpp]"]
  node_pipes["Debuggee stdio pipes<br/>[pipes.cpp]"]
end

subgraph group_architecture["Architecture support"]
  node_x86debugger["x86 debugger runtime"]
  node_disasm86["x86 disassembler"]
end

node_user(("Debugger user"))
node_target(("Debuggee process"))

node_user -->|"provides options"| node_arguments
node_user -->|"enters commands"| node_command
node_arguments -->|"parses arguments"| node_x64main
node_arguments -->|"parses arguments"| node_x86main
node_x64main -->|"starts debugger"| node_lifecycle
node_x86main -->|"starts debugger"| node_x86debugger
node_lifecycle -->|"launches or attaches"| node_target
node_command -->|"controls execution"| node_events
node_events -->|"handles stops"| node_breakpoints
node_command -->|"sets breakpoints"| node_breakpoints
node_command -->|"reads and writes"| node_memory
node_command -->|"views and sets"| node_registers
node_command -->|"requests inspection"| node_inspection
node_command -->|"resolves symbols"| node_symbols
node_inspection -->|"disassembles code"| node_disasm64
node_command -->|"requests dumps"| node_dump
node_dump -->|"rebuilds image"| node_pe
node_command -->|"configures bypasses"| node_anti
node_command -->|"configures logging"| node_hooks
node_command -->|"configures capture"| node_network
node_target -->|"sends captured traffic"| node_network
node_target -->|"exchanges stdio"| node_pipes
node_command -.->|"controls x86 target"| node_x86debugger
node_x86debugger -->|"disassembles code"| node_disasm86

click node_arguments "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/cli/argument_parser.cpp"
click node_x64main "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/main.cpp"
click node_x86main "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger32/main.cpp"
click node_command "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_commands.cpp"
click node_lifecycle "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_lifecycle.cpp"
click node_events "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_events.cpp"
click node_breakpoints "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_breakpoints.cpp"
click node_memory "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_memory.cpp"
click node_registers "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_registers.cpp"
click node_symbols "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_symbols.cpp"
click node_inspection "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_print.cpp"
click node_dump "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_dump.cpp"
click node_pe "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/pe/pe_image.c"
click node_disasm64 "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/disasm/x64_disassembler.cpp"
click node_anti "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_api_emulation.cpp"
click node_hooks "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_hooks.cpp"
click node_network "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_net.cpp"
click node_pipes "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/pipes.cpp"
click node_x86debugger "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger32/debugger/debugger_events.cpp"
click node_disasm86 "https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger32/disasm/x86_disassembler.cpp"

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_arguments,node_x64main,node_x86main,node_command,node_user toneBlue
class node_lifecycle,node_events,node_breakpoints,node_memory,node_registers toneAmber
class node_symbols,node_inspection,node_dump,node_pe,node_disasm64 toneMint
class node_anti,node_hooks,node_network,node_pipes toneRose
class node_x86debugger,node_disasm86,node_target toneIndigo
```

## Components

### CLI interaction

- [Argument parser](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/cli/argument_parser.cpp): `cli-debugger/cli/argument_parser.cpp`
- [x64 entry point](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/main.cpp): `cli-debugger/main.cpp`
- [x86 entry point](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger32/main.cpp): `cli-debugger32/main.cpp`
- [Command interpreter](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_commands.cpp): `cli-debugger/debugger/debugger_commands.cpp`

### Debug runtime

- [Launch and attach](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_lifecycle.cpp): `cli-debugger/debugger/debugger_lifecycle.cpp`
- [Event loop](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_events.cpp): `cli-debugger/debugger/debugger_events.cpp`
- [Breakpoints](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_breakpoints.cpp): `cli-debugger/debugger/debugger_breakpoints.cpp`
- [Memory operations](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_memory.cpp): `cli-debugger/debugger/debugger_memory.cpp`
- [Registers and context](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_registers.cpp): `cli-debugger/debugger/debugger_registers.cpp`

### Inspection and unpacking

- [Symbols and modules](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_symbols.cpp): `cli-debugger/debugger/debugger_symbols.cpp`
- [Debug inspection](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_print.cpp): `cli-debugger/debugger/debugger_print.cpp`
- [Dump and rebuild](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_dump.cpp): `cli-debugger/debugger/debugger_dump.cpp`
- [PE image support](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/pe/pe_image.c): `cli-debugger/pe/pe_image.c`
- [x64 disassembler](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/disasm/x64_disassembler.cpp): `cli-debugger/disasm/x64_disassembler.cpp`

### Instrumentation and capture

- [API emulation and guards](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_api_emulation.cpp): `cli-debugger/debugger/debugger_api_emulation.cpp`
- [API hooks](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_hooks.cpp): `cli-debugger/debugger/debugger_hooks.cpp`
- [Network capture](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/debugger_net.cpp): `cli-debugger/debugger/debugger_net.cpp`
- [Debuggee stdio pipes](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger/debugger/pipes.cpp): `cli-debugger/debugger/pipes.cpp`

### Architecture support

- [x86 debugger runtime](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger32/debugger/debugger_events.cpp): `cli-debugger32/debugger/debugger_events.cpp`
- [x86 disassembler](https://github.com/airaccelerate/cli-debugger/blob/main/cli-debugger32/disasm/x86_disassembler.cpp): `cli-debugger32/disasm/x86_disassembler.cpp`

### Other components

- **Debugger user**
- **Debuggee process**

## Connections

- Debugger user → Argument parser: provides options (evidence: `README.md`)
- Debugger user → Command interpreter: enters commands (evidence: `README.md`)
- Argument parser → x64 entry point: parses arguments (evidence: `cli-debugger/main.cpp`)
- Argument parser → x86 entry point: parses arguments (evidence: `cli-debugger32/main.cpp`)
- x64 entry point → Launch and attach: starts debugger (evidence: `cli-debugger/main.cpp`)
- x86 entry point → x86 debugger runtime: starts debugger (evidence: `cli-debugger32/main.cpp`)
- Launch and attach → Debuggee process: launches or attaches (evidence: `README.md`)
- Command interpreter → Event loop: controls execution (evidence: `README.md`)
- Event loop → Breakpoints: handles stops (evidence: `README.md`)
- Command interpreter → Breakpoints: sets breakpoints (evidence: `README.md`)
- Command interpreter → Memory operations: reads and writes (evidence: `README.md`)
- Command interpreter → Registers and context: views and sets (evidence: `README.md`)
- Command interpreter → Debug inspection: requests inspection (evidence: `README.md`)
- Command interpreter → Symbols and modules: resolves symbols (evidence: `README.md`)
- Debug inspection → x64 disassembler: disassembles code
- Command interpreter → Dump and rebuild: requests dumps (evidence: `README.md`)
- Dump and rebuild → PE image support: rebuilds image (evidence: `README.md`)
- Command interpreter → API emulation and guards: configures bypasses (evidence: `README.md`)
- Command interpreter → API hooks: configures logging (evidence: `README.md`)
- Command interpreter → Network capture: configures capture (evidence: `README.md`)
- Debuggee process → Network capture: sends captured traffic (evidence: `README.md`)
- Debuggee process → Debuggee stdio pipes: exchanges stdio (evidence: `README.md`)
- Command interpreter → x86 debugger runtime: controls x86 target
- x86 debugger runtime → x86 disassembler: disassembles code
