# blacksentinel-tech/linux-c.o.s architecture

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

- Interactive diagram: https://gitdiagram.com/blacksentinel-tech/linux-c.o.s
- Repository: https://github.com/blacksentinel-tech/linux-c.o.s

## Overview

Linux-C.O.S is a Debian/Kali-based security distribution assembled as a bootable ISO. Its installed-system workflow spans a hardened desktop, offensive toolsets, blue-team stacks, first-boot/session setup, and a Calamares installer; the repository also provides a static bilingual website and searchable tool catalog. The tree documents these product areas, but sampled runtime sources are mainly website/data utilities, so product-stage connections are documentation-based and build internals are intentionally omitted.

Main entry points: [`build/config/package-lists/desktop-xfce.list.chroot`](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/package-lists/desktop-xfce.list.chroot) (XFCE Desktop), [`website`](https://github.com/blacksentinel-tech/linux-c.o.s/tree/main/website) (Static Website), [`website/assets/data/tools-data.js`](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/website/assets/data/tools-data.js) (Catalog Data), [`scripts/build-website-data.py`](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/scripts/build-website-data.py) (Tool Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_os["Linux Distribution"]
  node_iso["Bootable ISO"]
  node_desktop["XFCE Desktop"]
  node_hardening["System Hardening"]
end

subgraph group_security["Security Capabilities"]
  node_offensive["Offensive Tools"]
  node_parrot["Parrot Tools"]
  node_blackarch["BlackArch Tools"]
  node_blue["Blue-Team Stacks<br/>[blueteam-stacks]"]
  node_ai["AI Profiles<br/>[profiles]"]
end

subgraph group_setup["Setup and Install"]
  node_firstboot["First-Boot Setup"]
  node_session["Session Setup"]
  node_installer["Calamares Installer<br/>[settings.conf]"]
end

subgraph group_site["Website"]
  node_website["Static Website"]
  node_catalog["Tool Catalog"]
  node_website_render["Page Renderer<br/>[build-website.py]"]
  node_catalog_data["Catalog Data<br/>[tools-data.js]"]
  node_graph_render["Graph Renderer"]
end

node_user(("Operator"))
node_operator(("Website Visitor"))

node_user -->|"boots"| node_iso
node_iso -->|"provides"| node_desktop
node_iso -.->|"includes"| node_hardening
node_desktop -.->|"offers"| node_offensive
node_desktop -.->|"offers"| node_parrot
node_desktop -.->|"offers"| node_blackarch
node_desktop -.->|"offers"| node_blue
node_desktop -.->|"offers"| node_ai
node_iso -.->|"runs"| node_firstboot
node_iso -.->|"runs"| node_session
node_user -.->|"installs with"| node_installer
node_operator -->|"visits"| node_website
node_catalog -->|"generates"| node_catalog_data
node_website_render -->|"renders pages"| node_website
node_website -.->|"loads catalog"| node_catalog_data
node_graph_render -.->|"presents graph"| node_user

click node_desktop "https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/package-lists/desktop-xfce.list.chroot"
click node_hardening "https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/hooks/normal/0050-hardening.hook.chroot"
click node_offensive "https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/package-lists/kali-security.list.chroot"
click node_parrot "https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/package-lists/parrot-exclusive.list.chroot"
click node_blackarch "https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/includes.chroot/usr/local/sbin/linux-cos-blackarch-pull"
click node_blue "https://github.com/blacksentinel-tech/linux-c.o.s/tree/main/build/config/includes.chroot/opt/linux-cos/blueteam-stacks"
click node_ai "https://github.com/blacksentinel-tech/linux-c.o.s/tree/main/build/config/includes.chroot/opt/linux-cos/ai/profiles"
click node_firstboot "https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/includes.chroot/usr/local/sbin/linux-cos-firstboot"
click node_session "https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/includes.chroot/usr/local/bin/linux-cos-session-setup"
click node_installer "https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/includes.chroot/etc/calamares/settings.conf"
click node_website "https://github.com/blacksentinel-tech/linux-c.o.s/tree/main/website"
click node_catalog "https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/scripts/build-website-data.py"
click node_website_render "https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/scripts/build-website.py"
click node_catalog_data "https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/website/assets/data/tools-data.js"
click node_graph_render "https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/scripts/render_second_brain.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_iso,node_desktop,node_hardening toneBlue
class node_offensive,node_parrot,node_blackarch,node_blue,node_ai toneAmber
class node_firstboot,node_session,node_installer toneMint
class node_website,node_catalog,node_website_render,node_catalog_data,node_graph_render toneRose
class node_user,node_operator toneIndigo
```

## Components

### Linux Distribution

- **Bootable ISO**
- [XFCE Desktop](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/package-lists/desktop-xfce.list.chroot): `build/config/package-lists/desktop-xfce.list.chroot`
- [System Hardening](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/hooks/normal/0050-hardening.hook.chroot): `build/config/hooks/normal/0050-hardening.hook.chroot`

### Security Capabilities

- [Offensive Tools](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/package-lists/kali-security.list.chroot): `build/config/package-lists/kali-security.list.chroot`
- [Parrot Tools](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/package-lists/parrot-exclusive.list.chroot): `build/config/package-lists/parrot-exclusive.list.chroot`
- [BlackArch Tools](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/includes.chroot/usr/local/sbin/linux-cos-blackarch-pull): `build/config/includes.chroot/usr/local/sbin/linux-cos-blackarch-pull`
- [Blue-Team Stacks](https://github.com/blacksentinel-tech/linux-c.o.s/tree/main/build/config/includes.chroot/opt/linux-cos/blueteam-stacks): `build/config/includes.chroot/opt/linux-cos/blueteam-stacks`
- [AI Profiles](https://github.com/blacksentinel-tech/linux-c.o.s/tree/main/build/config/includes.chroot/opt/linux-cos/ai/profiles): `build/config/includes.chroot/opt/linux-cos/ai/profiles`

### Setup and Install

- [First-Boot Setup](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/includes.chroot/usr/local/sbin/linux-cos-firstboot): `build/config/includes.chroot/usr/local/sbin/linux-cos-firstboot`
- [Session Setup](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/includes.chroot/usr/local/bin/linux-cos-session-setup): `build/config/includes.chroot/usr/local/bin/linux-cos-session-setup`
- [Calamares Installer](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/build/config/includes.chroot/etc/calamares/settings.conf): `build/config/includes.chroot/etc/calamares/settings.conf`

### Website

- [Static Website](https://github.com/blacksentinel-tech/linux-c.o.s/tree/main/website): `website`
- [Tool Catalog](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/scripts/build-website-data.py): `scripts/build-website-data.py`
- [Page Renderer](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/scripts/build-website.py): `scripts/build-website.py`
- [Catalog Data](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/website/assets/data/tools-data.js): `website/assets/data/tools-data.js`
- [Graph Renderer](https://github.com/blacksentinel-tech/linux-c.o.s/blob/main/scripts/render_second_brain.py): `scripts/render_second_brain.py`

### Other components

- **Operator**
- **Website Visitor**

## Connections

- Operator → Bootable ISO: boots (evidence: `README.md`)
- Bootable ISO → XFCE Desktop: provides (evidence: `README.md`)
- Bootable ISO → System Hardening: includes
- XFCE Desktop → Offensive Tools: offers
- XFCE Desktop → Parrot Tools: offers
- XFCE Desktop → BlackArch Tools: offers
- XFCE Desktop → Blue-Team Stacks: offers
- XFCE Desktop → AI Profiles: offers
- Bootable ISO → First-Boot Setup: runs
- Bootable ISO → Session Setup: runs
- Operator → Calamares Installer: installs with
- Website Visitor → Static Website: visits (evidence: `README.md`)
- Tool Catalog → Catalog Data: generates (evidence: `scripts/build-website-data.py`)
- Page Renderer → Static Website: renders pages (evidence: `scripts/build-website.py`)
- Static Website → Catalog Data: loads catalog
- Graph Renderer → Operator: presents graph
