# jimtwenty2/reconix-tui-sample architecture

> Architecture diagram of the GitHub repository jimtwenty2/reconix-tui-sample, 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/jimtwenty2/reconix-tui-sample
- Repository: https://github.com/jimtwenty2/reconix-tui-sample

## Overview

Reconix is a small Textual terminal UI sample that simulates a host-reconnaissance scan. The user enters a target; the app launches an exclusive asynchronous worker that emits simulated host rows and progress to the UI. The scan phases described in comments are placeholders, not implemented stages. The graph reflects the sampled source; no separate scanning or persistence subsystem is present.

Main entry points: [`app/main.py`](https://github.com/jimtwenty2/reconix-tui-sample/blob/main/app/main.py) (Scan worker), [`main.py`](https://github.com/jimtwenty2/reconix-tui-sample/blob/main/main.py) (CLI launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_launcher["CLI launcher<br/>[main.py]"]
node_app["Textual app<br/>[main.py]"]
node_target_input["Target input<br/>[main.py]"]
node_scan_worker["Scan worker<br/>[main.py]"]
node_activity_log["Activity log<br/>[main.py]"]
node_host_table["Host table<br/>[main.py]"]
node_progress_bar["Progress bar<br/>[main.py]"]

node_user -->|"enters target"| node_target_input
node_launcher -->|"starts app"| node_app
node_app -->|"composes"| node_target_input
node_target_input -->|"submits target"| node_scan_worker
node_scan_worker -->|"writes updates"| node_activity_log
node_scan_worker -->|"adds rows"| node_host_table
node_scan_worker -->|"updates progress"| node_progress_bar

click node_launcher "https://github.com/jimtwenty2/reconix-tui-sample/blob/main/main.py"
click node_app "https://github.com/jimtwenty2/reconix-tui-sample/blob/main/app/main.py"
click node_target_input "https://github.com/jimtwenty2/reconix-tui-sample/blob/main/app/main.py"
click node_scan_worker "https://github.com/jimtwenty2/reconix-tui-sample/blob/main/app/main.py"
click node_activity_log "https://github.com/jimtwenty2/reconix-tui-sample/blob/main/app/main.py"
click node_host_table "https://github.com/jimtwenty2/reconix-tui-sample/blob/main/app/main.py"
click node_progress_bar "https://github.com/jimtwenty2/reconix-tui-sample/blob/main/app/main.py"

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_user toneBlue
class node_launcher,node_app,node_target_input,node_activity_log,node_host_table,node_progress_bar toneTeal
class node_scan_worker toneRose
```

## Components

### Other components

- **User**
- [CLI launcher](https://github.com/jimtwenty2/reconix-tui-sample/blob/main/main.py): `main.py`
- [Textual app](https://github.com/jimtwenty2/reconix-tui-sample/blob/main/app/main.py): `app/main.py`
- [Target input](https://github.com/jimtwenty2/reconix-tui-sample/blob/main/app/main.py): `app/main.py`
- [Scan worker](https://github.com/jimtwenty2/reconix-tui-sample/blob/main/app/main.py): `app/main.py`
- [Activity log](https://github.com/jimtwenty2/reconix-tui-sample/blob/main/app/main.py): `app/main.py`
- [Host table](https://github.com/jimtwenty2/reconix-tui-sample/blob/main/app/main.py): `app/main.py`
- [Progress bar](https://github.com/jimtwenty2/reconix-tui-sample/blob/main/app/main.py): `app/main.py`

## Connections

- User → Target input: enters target (evidence: `app/main.py`)
- CLI launcher → Textual app: starts app (evidence: `main.py`)
- Textual app → Target input: composes (evidence: `app/main.py`)
- Target input → Scan worker: submits target (evidence: `app/main.py`)
- Scan worker → Activity log: writes updates (evidence: `app/main.py`)
- Scan worker → Host table: adds rows (evidence: `app/main.py`)
- Scan worker → Progress bar: updates progress (evidence: `app/main.py`)
