Projektüberblick — Shell Sentinel

Mission

Ein terminalnativer KI-Copilot, der persistente SSH/SFTP-Sitzungen hält, natürliche Sprache versteht und menschenfreundliche Operationen auf kritischer Infrastruktur ermöglicht.

Technischer Stack

• Python 3.12, Textual 8.2.7 für die TUI, Strands Agents SDK ≥1.45 für konversationelles Reasoning.
• Reproduzierbare Installation mit pyproject.toml und pip-tools-Lockfiles (make lock, make install).
• Eigene Tools: remote_ssh_command, remote_sftp_transfer, local_datetime.
• Firecrawl-MCP-Tools für Recherche, Scraping und strukturierte Extraktion.

Kernverantwortlichkeiten

• Konfiguration zentral in conf/; keine Hardcodes im Quellcode.
• Übersetzungen, Handbücher und statische Website bei Verhaltensänderungen aktualisieren.
• Eigene Provider und Plugin-Regeln dokumentieren; jedes Plugin mit kurzer Operator-Doku.
• Sicherheitsrichtlinien einhalten (keine Klartext-Secrets, nur Umgebungsvariablen).

Workflow

1. Virtualenv mit python3.12 -m venv .venv erstellen und aktivieren.
2. Abhängigkeiten mit make install installieren.
3. Vor PRs: make format, make lint, make test.
4. TUI mit make run und Website mit make website-serve validieren.

Vollständige Richtlinien im Beitragsleitfaden und in der Governance-Dokumentation. Die statische Website ist Teil des Produkt-Dokumentationsvertrags.