Dracon Utilities

Drei kleine Rust-CLI-Tools, die sich um eine Linux-Entwicklungsmaschine kümmern: Eines hält deine Git-Repos committet und gesichert, eines verhindert, dass deine Festplatte und dein Speicher überlaufen, und eines verhindert, dass Geheimnisse in deiner Git-Historie landen. Sie laufen als gewöhnliche systemd-Dienste auf Benutzerebene — kein Root erforderlich.

Tool	Das Problem, das es löst	In einer Zeile
`dracon-sync`	„Ich habe den ganzen Tag Dateien bearbeitet und nie committet."	Überwacht deine Repos, committet Änderungen automatisch mit deterministischen Nachrichten, pusht zu GitHub/GitLab/wohin auch immer
`dracon-system`	„Meine Festplatte lief mitten im Build voll und alles fror ein."	Schützt vor Festplatten- und Speicherdruck, bereinigt bekannte Speicherfresser, diagnostiziert Speicherprobleme
`dracon-warden`	„Ich hätte fast meinen API-Schlüssel zu GitHub gepusht."	Verschlüsselt Dateien in Geheimnisform transparent (age), sodass sie im Ruhezustand in Git sicher sind, in deinem Editor aber im Klartext vorliegen

Alles hier ist ein einziger Cargo-Workspace per Pfad: cargo test --workspace --locked im Repo- Stamm baut und testet alle drei (2347 Tests am 2026-10-10; 0 fehlgeschlagen, 25 ignoriert). Die drei Utility-Verzeichnisse sind verschachtelte eigenständige Git-Repos (eigene .git/, Historie, Remotes und Tags seit 2026-09-11 — das übergeordnete Repo verfolgt nur Meta-Dateien), daher baut ein bloßer Klon des übergeordneten Repos allein nicht; klone die Utility-Repos daneben (siehe CONTRIBUTING Setup).

In 60 Sekunden ausprobieren

git clone https://github.com/DraconDev/dracon-utilities.git
cd dracon-utilities
# nested utility repos (see CONTRIBUTING for the clone list)
git clone https://github.com/DraconDev/dracon-sync-background-auto-commit-multi-remote.git dracon-sync
git clone https://github.com/DraconDev/dracon-system-disk-process-guard-doctor.git dracon-system
git clone https://github.com/DraconDev/dracon-warden-secret-encrypt-age-git-filter.git dracon-warden
cargo build --release --locked

./target/release/dracon-system doctor      # health check of this machine
./target/release/dracon-sync status        # what sync would watch

Installation

./install.sh                                # binaries -> ~/.local/bin
systemctl --user enable --now dracon-sync.service        # background auto-commit
systemctl --user enable --now dracon-system-guard.service # background guard
./uninstall.sh                              # remove binaries and services (configs kept unless --purge)

`install.sh` stops the services while it works, refreshes the user
service units from the repo, installs the warden git hooks globally,
and restarts the services afterwards (see `./install.sh --help`;
`--no-restart` and `--binaries-only` opt out of parts of this).

dracon-warden ist kein Dienst – führe nach der Installation einmalig dracon-warden setup-hooks --global aus, um seine Git-Hooks zu aktivieren, und danach dracon-warden keygen, um das age-Schlüsselpaar der Maschine zu erzeugen.

Jedes Tool liest anschließend seine TOML-Konfiguration aus ~/.dracon/utilities/ (Beispiele liegen im jeweiligen Tool-Verzeichnis bei). Nichts, was von Git verfolgt wird, liegt jemals außerhalb des Repo-Baums; Zustandsdaten gehen nach ~/.dracon/ und ~/.local/state/dracon/.

Die Tools in der Praxis

`dracon-sync`

Du arbeitest; es committet. Gib ihm Watch-Roots (etwa ~/Dev), und es entdeckt jedes Git-Repo darunter, wartet, bis Änderungen abgeschlossen sind, committet mit deterministischen, diff-basierten Nachrichten und pusht zu origin sowie allen konfigurierten Mirrors. Es klassifiziert Push-Fehler (STUCK/BLOCKED/BROKEN), statt stillschweigend endlos erneut zu versuchen, und markiert Repos, die von der Festplatte verschwinden.

dracon-sync daemon              # continuous loop (what the service runs)
dracon-sync repos               # live report of every watched repo
dracon-sync sync-now ~/Dev/my-project
dracon-sync health

Mehr: dracon-sync/README.md

`dracon-system`

Ein Watchdog für die Maschine selbst. Wenn der Festplatten- oder Speicherdruck die Warn-/Kritisch-Schwellenwerte überschreitet, kann es regenerierbaren Ballast bereinigen (Build-Verzeichnisse, Caches), speicherhungrige Prozesse herabstufen, damit dein Desktop reaktionsfähig bleibt, und den Out-of-Memory-Killer des Kernels auf die tatsächlichen Verursacher ausrichten. Außerdem bietet es Einmal-Diagnosen: Speicher-Hotspots, Symlink-Verwaltung, zram-Status.

dracon-system doctor            # deterministic diagnostics pass
dracon-system storage ~/Dev     # where did my disk go?
dracon-system guard clean       # reclaim space (dry-run first)
dracon-system guard daemon      # continuous monitoring (the service)

Mehr: dracon-system/README.md

`dracon-warden`

Git-Filter-basierte Verschlüsselung mit age. Dateien, die den Secret-Mustern entsprechen (.env, *.key, …), werden beim Commit verschlüsselt und beim Checkout entschlüsselt, sodass der Arbeitsbaum normal bleibt, während das Remote nur Chiffretext enthält. Globale Hooks sichern dies ab, indem sie jeden Push auf inhalte mit Secret-Charakter scannen und riskante blockieren.

dracon-warden keygen            # machine age keypair
dracon-warden setup-hooks --global
dracon-warden status            # what's protected on this machine

Mehr: dracon-warden/README.md

Repository-Struktur

dracon-utilities/
├── dracon-sync/      # auto-commit multi-remote git sync daemon
├── dracon-system/    # disk/process guard, storage & diagnostics
├── dracon-warden/    # age-based git secret encryption (hooks + CLI)
│   └── src/security/ #   embedded dracon-security crate
├── .github/workflows/ci.yml  # lint / test / release-build / deny / nix
├── flake.nix         # optional Nix build path
├── scripts/          # release, checks, audit tooling
└── AGENTS.md         # policies for agents/operators working here

Entwicklung

export DRACON_SYNC_GIT_BIN=/run/current-system/sw/bin/git  # NixOS only
cargo test --workspace --locked
cargo clippy --workspace --locked -- -D warnings
cargo deny check
nix flake check                 # optional

Tool-spezifische Builds: cargo build --release --locked -p dracon-{sync,system,warden}.

Releases

Aktuelle Komponenten-Releases: dracon-sync 0.113.95 · dracon-system 0.112.44 · dracon-warden 0.113.15 — siehe Releases. Utility-Releases werden in den verschachtelten Repos getaggt (dracon-sync-vX.Y.Z, …); Details pro Tool befinden sich in der CHANGELOG.md des jeweiligen Verzeichnisses, und die übergeordnete CHANGELOG.md ist ein eingefrorenes historisches Protokoll.

Historischer Hinweis: Jedes Utility lebte ursprünglich in einem eigenen Repo (DraconDev/dracon-sync-background-auto-commit-multi-remote, ...-disk-process-guard-doctor, ...-secret-encrypt-age-git-filter). Die Entwicklung findet in den verschachtelten eigenständigen Checkouts dieser selben Repos statt, die neben diesem Meta-Repo geklont werden (das übergeordnete Repo verfolgt keinen Utility-Quellcode).

dracon-utilities

Beliebteste