kpmn-dev — terminal
~/kpmn $ ls docs/
-rw-r--r-- 02-sticks.md
-rw-r--r-- 04-aegis.md
-rwxr-xr-x troubleshoot.sh
~/kpmn $ cat docs/01-ueberblick.md01-overview.md▋

Was ist die KPMN USB-Stick Suite?What is the KPMN USB-Stick Suite?

Die KPMN USB-Stick Suite ist eine Sammlung von USB-Sticks, die jeweils einen konkreten Zweck rund um IT-Diagnose, System-Wiederherstellung und Neuinstallation abdecken. Jeder Stick ist eine eigenständige, portable Windows-Anwendung mit einem eigenen dunklen Kpmn-Theme und eigener Akzentfarbe. AEGIS bindet sie alle zusammen: es erkennt angeschlossene Sticks live, verwaltet einen verschlüsselten Datei-Tresor, Vorlagen und Backups – und kann die anderen drei Sticks (AVAS, DART, MABS) direkt selbst bauen und aktuell halten.

Die Grundregel des ganzen Projekts: Kpmn Development hostet niemals Software Dritter. Installer, Treiber und Tools werden immer live von der offiziellen Herstellerquelle geladen – Kpmn Development verteilt ausschließlich seinen eigenen Code (AEGIS, AVAS, DART, das MABS-Theme).

The KPMN USB-Stick Suite is a collection of USB sticks, each covering a concrete purpose around IT diagnostics, system recovery, and reinstallation. Every stick is a standalone, portable Windows application with its own dark Kpmn theme and accent color. AEGIS ties them together: it detects connected sticks live, manages an encrypted file vault, templates and backups – and can build and update the other three sticks (AVAS, DART, MABS) itself.

The project's core rule: Kpmn Development never hosts third-party software. Installers, drivers and tools are always fetched live from the official vendor source – Kpmn Development only ever distributes its own code (AEGIS, AVAS, DART, the MABS theme).

~/kpmn $ cat docs/02-sticks.md▋

Die 5 SticksThe 5 sticks

StickZweckPurposeStatusStatus
AEGIS Zentrale Verwaltung: Tresor, Vorlagen, Backups, Suite BuilderCentral management: vault, templates, backups, Suite Builder fertigdone
AVAS Automatisierte Software- & Treiberinstallation für NeuaufsetzungenAutomated software & driver install for fresh Windows setups fertigdone
DART Diagnose- & Analyse-Toolkit (Hardware, Disk, Netzwerk, Prozesse)Diagnostic & analysis toolkit (hardware, disk, network, processes) fertigdone
MABS Multi-Boot-Stick auf Ventoy-Basis für OS-InstallationsmedienMulti-boot stick on Ventoy for OS installation media fertigdone
Stick 5 Portables Ubuntu-SystemPortable Ubuntu system geplantplanned
~/kpmn $ cat docs/03-infrastruktur.md03-infrastructure.md▋

Woher AEGIS die Sticks lädtWhere AEGIS gets the sticks from

AVAS, DART und MABS liegen als fertige Releases in drei privaten GitHub-Repos. AEGIS' Suite Builder lädt von dort ausschließlich die aktuellste Version – niemals Quellcode zum lokal Kompilieren, sondern fertige, self-contained Binaries, damit auch ein frisch aufgesetzter Ziel-PC ohne .NET SDK funktioniert.

AVAS, DART and MABS sit as finished releases in three private GitHub repos. AEGIS's Suite Builder only ever downloads the latest version from there – never source code to compile locally, but a finished, self-contained binary, so a freshly reimaged target PC works even without the .NET SDK installed.

◆ Keine Einrichtung nötigNo setup required AEGIS bringt einen fest einkompilierten, nur lesenden Zugriffstoken mit, beschränkt auf genau diese drei Repos. Der Suite Builder funktioniert deshalb sofort nach dem ersten Start – keine Server-Adresse, kein eigener Token, kein Einrichtungsschritt. AEGIS ships with a compiled-in, read-only access token, scoped to only these three repos. The Suite Builder therefore works immediately after the first launch – no server address, no token of your own, no setup step.

Diese drei Repos folgen einer strengeren Regel als AEGIS' eigener Quellcode: nur fertig getesteter, wasserdichter Stand kommt hier rein, nie Zwischenstände oder work-in-progress – schließlich wird alles, was hier liegt, automatisch auf andere Geräte übertragen, sobald jemand den Suite Builder benutzt.

These three repos follow a stricter rule than AEGIS's own source: only fully tested, watertight builds go here, never intermediate or work-in-progress states – everything that lives here gets carried onto other people's devices automatically the moment someone uses the Suite Builder.

ⓘ AEGIS selbst herunterladenDownloading AEGIS itself AEGIS gibt es ebenfalls als fertigen, self-contained Release – auf der Releases-Seite dieses Repos. Zip entpacken, AEGIS.exe starten – kein .NET SDK, keine IDE, keine Installation nötig. AEGIS is also available as a finished, self-contained release – on this repo's Releases page. Extract the zip, run AEGIS.exe – no .NET SDK, no IDE, no installation needed.
~/kpmn $ cat docs/04-aegis.md▋

AEGIS im DetailAEGIS in detail

TabFunktionFunction
DokumenteDocuments Dateinavigation auf dem jeweils erkannten Stick, inkl. AVAS-Erinnerung, wenn Treiber-/Paket-Datenbank veraltet ist.File navigation on whichever stick is currently detected, including an AVAS reminder when its driver/package database is out of date.
Vault Verschlüsselter Universal-Dateispeicher (AES-256-GCM + PBKDF2). Bewusst kein Passwort-Manager – und bewusst keine Passwort-Wiederherstellung.Encrypted general-purpose file store (AES-256-GCM + PBKDF2). Deliberately not a password manager – and deliberately no password recovery.
Templates Dokumentvorlagen (Save-As-Workflow) und wiederverwendbare Text-Snippets.Document templates (Save-As workflow) and reusable text snippets.
Geräte BackupsDevice Backups Treiber-Backup (DISM), Nutzerdaten-Backup und WLAN-Zugangsdaten-Backup (landet verschlüsselt im Vault).Driver backup (DISM), user-data backup, and WLAN credentials backup (stored encrypted inside the Vault).
Suite Builder Der Hauptgrund, warum AEGIS existiert – baut und aktualisiert AVAS, DART und MABS.The main reason AEGIS exists – builds and updates AVAS, DART and MABS.
~/kpmn $ cat docs/05-suite-builder.md▋

Suite Builder: KonzeptSuite Builder: concept

Für jeden Stick gibt es im Suite Builder eine eigene Karte mit Laufwerksauswahl und Build-Button. AEGIS unterscheidet automatisch zwei Modi, je nachdem, ob die aktuelle Laufwerksbezeichnung schon zum Zielstick passt:

Every stick gets its own card in the Suite Builder, with a drive picker and a build button. AEGIS automatically distinguishes two modes, depending on whether the drive's current volume label already matches the target stick:

ModusMode WannWhen VerhaltenBehavior
Neuer StickNew stick Laufwerksbezeichnung stimmt nicht mit dem Zielstick übereinVolume label doesn't match the target stick Laufwerk wird vollständig geleert, deutliche Warnung vorherDrive is fully wiped, clear warning beforehand
AktualisierenUpdate Laufwerk heißt schon so wie der Zielstick (z.B. schon "AVAS")Drive is already labeled like the target stick (e.g. already "AVAS") Nur die Programmdateien werden überschrieben, restliche Inhalte bleibenOnly the program files get overwritten, everything else stays
◆ SicherheitsnetzSafety net Das Laufwerk, von dem AEGIS gerade selbst läuft, taucht in keinem der drei Dropdowns auf – es kann also nie versehentlich als Ziel gewählt werden. The drive AEGIS is currently running from never appears in any of the three dropdowns – so it can never accidentally be chosen as a target.
~/kpmn/avas $ ./build.sh --steps
  1. Laufwerk wählen & bauenPick a drive & build

    Zielstick im Dropdown der AVAS-Karte auswählen, Stick bauen klicken, Warnung bestätigen.

    Select the target drive in the AVAS card's dropdown, click Build stick, confirm the warning.

  2. Treiber-Datenbank wählenChoose the driver database

    Nach dem Build erscheint automatisch ein Dialog mit zwei Optionen:

    A dialog appears automatically after the build, offering two options:

    Vollständig Du besorgst SDIs komplette Offline-Datenbank selbst (nur als ~50 GB-Torrent verfügbar).You source SDI's complete offline database yourself (only available as a ~50 GB torrent).
    Lite AEGIS lädt automatisch den offiziellen Intel-Ethernet-Treiber (sichert Internetzugang bei Neuinstallation) sowie das SDIO-Scan-Tool selbst; Realtek/Intel-WLAN gibt's als klickbare Links zum manuellen Nachrüsten.AEGIS auto-downloads the official Intel Ethernet driver (guarantees internet access on a fresh install) plus the SDIO scan tool itself; Realtek/Intel-WLAN come as clickable links for manual follow-up.
  3. Software-Pakete herunterladenDownload software packages

    Direkt danach folgt ein zweiter Dialog: 7 Alltagsprogramme (Firefox, Chrome, Brave, 7-Zip, VLC, Notepad++, VS Code) werden live von den Herstellerseiten geladen.

    A second dialog follows right after: 7 everyday programs (Firefox, Chrome, Brave, 7-Zip, VLC, Notepad++, VS Code) are downloaded live from their vendor sites.

    ⓘ Brave Brave ist ein Online-Stub-Installer (~1,3 MB) – der Zielrechner braucht Internet, um die Installation abzuschließen. Alle anderen 6 sind vollständige Offline-Installer. Der Hinweis erscheint sowohl im Build-Dialog als auch später direkt in AVAS selbst. Brave is an online-stub installer (~1.3 MB) – the target machine needs internet to finish installing it. The other 6 are full offline installers. This is flagged both in the build dialog and later inside AVAS itself.
~/kpmn/dart $ ./build.sh --steps
  1. Laufwerk wählen & bauenPick a drive & build

    Genauso wie bei AVAS: Laufwerk wählen, bauen, Warnung bestätigen.

    Same as AVAS: pick a drive, build, confirm the warning.

  2. Debugging-Tools herunterladenDownload debugging tools

    Ein Dialog lädt automatisch 5 der 7 Tools; 2 brauchen einen manuellen Schritt, weil ihre einzigen Quellen Bot-Schutz gegen automatisierte Downloads einsetzen:

    A dialog auto-downloads 5 of the 7 tools; 2 need a manual step because their only sources run bot protection against automated downloads:

    ToolKategorieCategory
    CPU-Z01 – Hardwareauto
    HWiNFO01 – Hardwaremanual
    CrystalDiskInfo02 – Diskmanual
    WiFi Channel Monitor03 – Netzwerkauto
    System Informer05 – Prozesseauto
    Sysinternals Suite05 – Prozesseauto
    TreeSize06 – Sonstigesauto

    Für die beiden manuellen Tools zeigt der Dialog einen klickbaren Link plus den genauen Zielordner auf dem Stick.

    For the two manual tools the dialog shows a clickable link plus the exact target folder on the stick.

~/kpmn/mabs $ ./ventoy-warning.sh

MABS ist grundlegend anders: statt Dateien zu kopieren, installiert AEGIS hier Ventoy (Bootloader + Partitionierung) direkt auf den Datenträger. Das ist unwiderruflich – deshalb bekommt MABS die deutlichste Warnung im ganzen Suite Builder.

MABS is fundamentally different: instead of copying files, AEGIS installs Ventoy (bootloader + partitioning) directly onto the drive. That's irreversible – which is why MABS carries the most severe warning anywhere in the Suite Builder.

  1. Laufwerk wählenPick a drive

    In der MABS-Karte das Zielaufwerk auswählen.

    Select the target drive in the MABS card.

  2. "Ventoy installieren" klickenClick "Install Ventoy"
    ▲ Keine einfache DateilöschungNot a simple file deletion Der Bestätigungsdialog nennt Laufwerksbuchstabe, aktuelle Bezeichnung und Größe – und macht ausdrücklich klar, dass es sich um eine komplette Neupartitionierung handelt, nicht um eine Dateilöschung. ALLE Daten gehen dabei endgültig verloren. The confirmation dialog names the drive letter, current label and size – and explicitly states this is a complete repartition, not a file deletion. ALL data is destroyed permanently.
  3. Ventoy wird installiertVentoy gets installed

    Ventoy selbst wird live von der offiziellen GitHub-Seite geladen (nie von uns gehostet) und per Ventoy2Disk.exe VTOYCLI elevated installiert – ein UAC-Fenster erscheint.

    Ventoy itself is fetched live from its official GitHub page (never hosted by us) and installed elevated via Ventoy2Disk.exe VTOYCLI – a UAC prompt appears.

  4. Kpmn-Theme wird übernommenKpmn theme gets applied

    Nach erfolgreicher Installation kopiert AEGIS das Kpmn-Theme vom MABS-GitHub-Repo nach <Laufwerk>\ventoy\.

    After a successful install, AEGIS copies the Kpmn theme from the MABS GitHub repo to <drive>\ventoy\.

  5. Betriebssystem-Abbilder (optional)OS images (optional)
    Ubuntu · Kali Werden auf Wunsch automatisch von den jeweils offiziellen Download-Seiten direkt auf die Ventoy-Datenpartition geladen (mehrere GB, dauert entsprechend).Downloaded automatically on request, straight from their official download pages onto the Ventoy data partition (several GB, takes a while). auto
    Windows Microsofts Download ist session-gated (Links laufen nach 24 Std. ab) und nicht automatisierbar – der Dialog verlinkt stattdessen direkt auf die echte offizielle Download-Seite.Microsoft's download is session-gated (links expire after 24h) and can't be automated – the dialog links directly to the real official download page instead. manual
~/kpmn $ cat docs/06-sicherheit.md06-security.md▋

Sicherheit & PolicySafety & policy

  • Keine Software Dritter wird von Kpmn Development gehostet – jeder Download kommt live vom Hersteller.
  • Destruktive Aktionen (Neubau, Ventoy-Formatierung) verlangen immer eine explizite Bestätigung, die das genaue Ziellaufwerk benennt.
  • Das AEGIS-eigene Laufwerk ist in allen Build-Dropdowns unsichtbar.
  • Der Vault hat bewusst keine Passwort-Wiederherstellung – ein vergessenes Passwort bedeutet endgültigen Datenverlust.
  • No third-party software is hosted by Kpmn Development – every download comes live from the vendor.
  • Destructive actions (new build, Ventoy format) always require an explicit confirmation naming the exact target drive.
  • AEGIS's own drive is invisible in every build dropdown.
  • The Vault deliberately has no password recovery – a forgotten password means permanent data loss.
~/kpmn $ man troubleshoot▋

Troubleshooting

ProblemProblemLösungFix
"Version konnte nicht abgerufen werden""Could not fetch version" Meist ein Netzwerk-/Internetproblem auf dem PC, auf dem AEGIS läuft – GitHub-Erreichbarkeit prüfen und über Aktualisieren erneut versuchen. Einrichtung ist keine nötig, der Zugriffstoken steckt fest in AEGIS.Usually a network/internet issue on the machine running AEGIS – check that GitHub is reachable and try again via Refresh. No setup is needed, the access token is baked into AEGIS.
Ein Download schlägt mit Fehler fehlA download fails with an error Alle Download-Schritte sind absichtlich nicht blockierend – der Stick bleibt nutzbar, es fehlt nur das eine Tool/Paket. Einfach später erneut versuchen oder manuell nachrüsten.Every download step is deliberately non-blocking – the stick stays usable, only that one tool/package is missing. Just retry later or add it manually.
Falsches Icon wird nach einem Update angezeigtWrong icon shown after an update Windows-Explorer-Icon-Cache – Datei einmal umbenennen/zurückbenennen oder den Explorer-Ordner neu öffnen.Windows Explorer icon cache – rename the file back and forth once, or reopen the Explorer folder.
KPMN USB-Stick Suite · AEGIS Handbuch · von Felix Koopmann (Kpmn Development), gebaut mit Claude KPMN USB-Stick Suite · AEGIS Handbook · by Felix Koopmann (Kpmn Development), built with Claude
~/kpmn $ ▋