# adaptix-framework/adaptixc2 architecture

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

- Interactive diagram: https://gitdiagram.com/adaptix-framework/adaptixc2
- Repository: https://github.com/adaptix-framework/adaptixc2

## Overview

AdaptixC2 is an extensible post-exploitation and adversarial-emulation framework for authorized testing. Operators use a cross-platform GUI to connect to a multiplayer server, manage sessions and targets, issue tasks, and inspect results such as command output and job state. Server-side task handling, persistence, eventing, and pluggable agents/listeners form distinct stages; AxScript provides an extension capability. The README documents the product workflow and major capabilities, but sampled implementation excerpts are limited, so component-level links not shown there are marked unverified.

Main entry points: [`AdaptixServer/core/connector/tc_tasks.go`](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/connector/tc_tasks.go) (Agent Connector), [`AdaptixClient/Headers/UI/MainUI.h`](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Headers/UI/MainUI.h) (Qt GUI), [`AdaptixServer/core/server/server.go`](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/server/server.go) (Server), [`AdaptixServer/extenders/beacon_agent/pl_main.go`](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/extenders/beacon_agent/pl_main.go) (Beacon Agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Operator Client"]
  node_gui["Qt GUI<br/>[MainUI.h]"]
  node_client_conn["Client Connection"]
  node_client_storage[("Client Storage<br/>[Storage.cpp]")]
  node_client_axscript["Client AxScript"]
  node_client_ax_engine["Script Engine<br/>[AxScriptEngine.cpp]"]
end

subgraph group_server["Server Services"]
  node_server["Server<br/>[server.go]"]
  node_task_handlers["Task Handling<br/>[ts_tasks.go]"]
  node_job_handler["Job Handling<br/>[mgr_handler_job.go]"]
  node_connector["Agent Connector<br/>[tc_tasks.go]"]
  node_server_axscript["Server AxScript<br/>[manager.go]"]
end

subgraph group_extensions["Extender Runtime"]
  node_beacon_agent["Beacon Agent<br/>[pl_main.go]"]
  node_beacon_jobs["Beacon Jobs<br/>[JobsController.cpp]"]
  node_gopher_agent["Gopher Agent<br/>[main.go]"]
  node_listeners["Listener Extenders"]
end

subgraph group_state["Persistence and Events"]
  node_database[("Task Database<br/>[db_tasks.go]")]
  node_eventing["Event Manager<br/>[evt_manager.go]"]
end

subgraph group_ui["Client Framework"]
  node_dock_framework["Docking Framework"]
  node_dock_api["Docking API<br/>[KDDockWidgets.h]"]
  node_session_graph["Session Graph<br/>[SessionsGraph.cpp]"]
end

node_operator(("Operator"))
node_external_agent(("Agent Sessions"))

node_operator -->|"operates"| node_gui
node_gui -.->|"requests server"| node_client_conn
node_client_conn -->|"encrypted communications"| node_server
node_server -.->|"routes tasks"| node_task_handlers
node_task_handlers -.->|"dispatches tasks"| node_connector
node_connector -.->|"communicates"| node_external_agent
node_external_agent -.->|"returns results"| node_connector
node_connector -.->|"reports jobs"| node_job_handler
node_job_handler -.->|"stores task state"| node_database
node_server -.->|"publishes events"| node_eventing
node_server -.->|"supports extensions"| node_server_axscript
node_client_axscript -->|"uses engine"| node_client_ax_engine
node_server_axscript -.->|"script capability"| node_client_axscript
node_beacon_agent -->|"tracks jobs"| node_beacon_jobs
node_beacon_agent -.->|"plugs into server"| node_connector
node_gopher_agent -.->|"plugs into server"| node_connector
node_listeners -.->|"provides transports"| node_server
node_gui -.->|"persists client data"| node_client_storage
node_gui -->|"visualizes sessions"| node_session_graph
node_gui -.->|"uses docking"| node_dock_api
node_dock_api -.->|"implements docking"| node_dock_framework

click node_gui "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Headers/UI/MainUI.h"
click node_client_conn "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Source/Client/HttpRequestManager.cpp"
click node_client_storage "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Source/Client/Storage.cpp"
click node_client_axscript "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Source/Client/AxScript/AxScriptManager.cpp"
click node_server "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/server/server.go"
click node_task_handlers "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/server/ts_tasks.go"
click node_job_handler "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/server/mgr_handler_job.go"
click node_connector "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/connector/tc_tasks.go"
click node_server_axscript "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/axscript/manager.go"
click node_database "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/database/db_tasks.go"
click node_eventing "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/eventing/evt_manager.go"
click node_beacon_agent "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/extenders/beacon_agent/pl_main.go"
click node_beacon_jobs "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/extenders/beacon_agent/src_beacon/beacon/JobsController.cpp"
click node_gopher_agent "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/extenders/gopher_agent/src_gopher/main.go"
click node_listeners "https://github.com/adaptix-framework/adaptixc2/tree/main/AdaptixServer/extenders"
click node_client_ax_engine "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Source/Client/AxScript/AxScriptEngine.cpp"
click node_dock_framework "https://github.com/adaptix-framework/adaptixc2/tree/main/AdaptixClient/Libs/kddockwidgets/core"
click node_dock_api "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Libs/kddockwidgets/KDDockWidgets.h"
click node_session_graph "https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Source/UI/Graph/SessionsGraph.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_gui,node_client_conn,node_client_storage,node_client_axscript,node_client_ax_engine toneBlue
class node_server,node_task_handlers,node_job_handler,node_connector,node_server_axscript toneAmber
class node_beacon_agent,node_beacon_jobs,node_gopher_agent,node_listeners toneMint
class node_database,node_eventing toneRose
class node_dock_framework,node_dock_api,node_session_graph,node_operator,node_external_agent toneIndigo
```

## Components

### Operator Client

- [Qt GUI](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Headers/UI/MainUI.h): `AdaptixClient/Headers/UI/MainUI.h`
- [Client Connection](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Source/Client/HttpRequestManager.cpp): `AdaptixClient/Source/Client/HttpRequestManager.cpp`
- [Client Storage](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Source/Client/Storage.cpp): `AdaptixClient/Source/Client/Storage.cpp`
- [Client AxScript](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Source/Client/AxScript/AxScriptManager.cpp): `AdaptixClient/Source/Client/AxScript/AxScriptManager.cpp`
- [Script Engine](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Source/Client/AxScript/AxScriptEngine.cpp): `AdaptixClient/Source/Client/AxScript/AxScriptEngine.cpp`

### Server Services

- [Server](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/server/server.go): `AdaptixServer/core/server/server.go`
- [Task Handling](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/server/ts_tasks.go): `AdaptixServer/core/server/ts_tasks.go`
- [Job Handling](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/server/mgr_handler_job.go): `AdaptixServer/core/server/mgr_handler_job.go`
- [Agent Connector](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/connector/tc_tasks.go): `AdaptixServer/core/connector/tc_tasks.go`
- [Server AxScript](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/axscript/manager.go): `AdaptixServer/core/axscript/manager.go`

### Extender Runtime

- [Beacon Agent](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/extenders/beacon_agent/pl_main.go): `AdaptixServer/extenders/beacon_agent/pl_main.go`
- [Beacon Jobs](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/extenders/beacon_agent/src_beacon/beacon/JobsController.cpp): `AdaptixServer/extenders/beacon_agent/src_beacon/beacon/JobsController.cpp`
- [Gopher Agent](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/extenders/gopher_agent/src_gopher/main.go): `AdaptixServer/extenders/gopher_agent/src_gopher/main.go`
- [Listener Extenders](https://github.com/adaptix-framework/adaptixc2/tree/main/AdaptixServer/extenders): `AdaptixServer/extenders`

### Persistence and Events

- [Task Database](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/database/db_tasks.go): `AdaptixServer/core/database/db_tasks.go`
- [Event Manager](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixServer/core/eventing/evt_manager.go): `AdaptixServer/core/eventing/evt_manager.go`

### Client Framework

- [Docking Framework](https://github.com/adaptix-framework/adaptixc2/tree/main/AdaptixClient/Libs/kddockwidgets/core): `AdaptixClient/Libs/kddockwidgets/core`
- [Docking API](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Libs/kddockwidgets/KDDockWidgets.h): `AdaptixClient/Libs/kddockwidgets/KDDockWidgets.h`
- [Session Graph](https://github.com/adaptix-framework/adaptixc2/blob/main/AdaptixClient/Source/UI/Graph/SessionsGraph.cpp): `AdaptixClient/Source/UI/Graph/SessionsGraph.cpp`

### Other components

- **Operator**
- **Agent Sessions**

## Connections

- Operator → Qt GUI: operates (evidence: `README.md`)
- Qt GUI → Client Connection: requests server
- Client Connection → Server: encrypted communications (evidence: `README.md`)
- Server → Task Handling: routes tasks
- Task Handling → Agent Connector: dispatches tasks
- Agent Connector → Agent Sessions: communicates
- Agent Sessions → Agent Connector: returns results
- Agent Connector → Job Handling: reports jobs
- Job Handling → Task Database: stores task state
- Server → Event Manager: publishes events
- Server → Server AxScript: supports extensions
- Client AxScript → Script Engine: uses engine (evidence: `AdaptixClient/Source/Client/AxScript/AxScriptManager.cpp`)
- Server AxScript → Client AxScript: script capability
- Beacon Agent → Beacon Jobs: tracks jobs (evidence: `AdaptixServer/extenders/beacon_agent/src_beacon/beacon/JobsController.cpp`)
- Beacon Agent → Agent Connector: plugs into server
- Gopher Agent → Agent Connector: plugs into server
- Listener Extenders → Server: provides transports
- Qt GUI → Client Storage: persists client data
- Qt GUI → Session Graph: visualizes sessions (evidence: `README.md`)
- Qt GUI → Docking API: uses docking
- Docking API → Docking Framework: implements docking (evidence: `AdaptixClient/Libs/kddockwidgets/core/DropArea.h`)
