Commander — Zentrale CLI-Steuerung

Der Commander (scripts/commander.py) ist das zentrale CLI-Interface für alle OpenAmer-Skripte (28 Subcommands).

Verwendung

python scripts/commander.py <subcommand> [args...]
python scripts/commander.py --status         # Alle Subsysteme prüfen
python scripts/commander.py --all            # Alle --check/--status nacheinander
python scripts/commander.py --help <cmd>     # Detail-Hilfe
python scripts/commander.py --list           # Alle Subcommands auflisten
python scripts/commander.py --version        # Version

Alle 28 Subcommands

Subcommand	Alias	Skript	Beschreibung
security	sec, cve	security-cve-scan.py	CVE-Scan + Auto-Patching
perf	performance, optimize	perf-optimizer.py	RAM/Disk/Cron-Optimierung
monitor	resources	resource-monitor.py	Live-CPU/RAM/DISK/NET
test	tests, testing	auto-test-runner.py	Auto-Test-Runner
heal	healing, selfheal	self-healer.py	Self-Healing-Daemon
graph	skillgraph, knowledge	skill-knowledge-graph.py	630+ Skills Knowledge Graph
cron	scheduler, jobs	smart-cron-scheduler.py	Cron-Job-Analyse
crew	agents	crew-manager.py	Multi-Agent-Crew
dashboard	dash, web	dashboard-server.py	Live-Web-Dashboard :8899
docs	documentation, doc	auto-docs.py	Automatische Dokumentation
sync	profiles, crossprofile	cross-profile-sync.py	Profil-Sync
voice	speech, audio	voice-assistant.py	STT + TTS Sprachassistent
health	predict, predhealth	predictive-health.py	ML-Prädiktive Health-Analyse
mesh	cluster	agent-mesh.py	Master/Worker Agent-Mesh
review	codereview, audit	auto-code-review.py	Auto-Code-Review
backup	backups	auto-backup.py	Auto-Backup aller Daten
resource	resources, system	resource-monitor.py	System-Ressourcen-Monitor
cache	cleancache	smart-cache.py	Cache-Analyse + Cleanup
abtest	ab, experiment	ab-test-engine.py	A/B-Experimente
logs	log, analyze	log-analyzer.py	Log-Analyse + Pattern
env	environment, check	auto-env-checker.py	Umgebungs-Validierung
traffic	apikey, ratelimit	traffic-cop.py	API-Key-Health + Rotation
sessions	session, archive	smart-session-saver.py	Session-Archivierung
updater	update, upgrade	auto-updater.py	Auto-Updater Git/pip/Skills
plugin	plugins	plugin-manager.py	Plugin-Verwaltung
bugbot	bugs, issues	bugbot.py	Bug-Tracking + Triage
pr_approval	pr, approval	pr_approval.py	PR-Approval-Workflow
security_agent	secagent, secbot	security_agent.py	CVE-Daemon Security-Agent

Features

• Farbige Ausgabe: 256-Farben-ANSI, kompatibel mit Windows 10+
• Tabellen: Automatische Spaltenbreiten, Header, Trennlinien
• Progress-Bar: Farbe, Prozent, ETA, Dauer — für --status und --all
• Alias-Auflösung: Alle Subcommands haben kurze Aliase
• Kategorie-Gruppierung: 11 Kategorien für Übersicht
• Exit-Codes: 0=OK, 1=Warnung, 2=Fehler, 3=Kritisch

Abhängigkeiten

Nur Python-Standardbibliothek (argparse, subprocess, json, pathlib, shutil, sys). Keine externen Packages.

Pfade

• scripts/commander.py im OpenAmer-Repo (source)
• OPENAMER_HOME/scripts/commander.py (runtime)

Exit-Codes

Exit	Bedeutung
0	Alles OK
1	Warnungen vorhanden
2	Fehler in Subsystemen
130	Abbruch durch Benutzer (Ctrl+C)

Hinweise

• --status prüft nur Subcommands mit definiertem status_flag (--check, --status, --once etc.)
• --all führt alle Status-prüfenden Subcommands nacheinander aus
• Bei Timeout (124) wird das Skript übersprungen
• Output wird auf 80 Zeilen gekürzt bei langen Ausgaben

Pflege

Neue Subcommands hinzufügen: Eintrag in SUBCMDS-Dict mit script, desc, aliases, color, icon, category und optional status_flag.