agensic v0.3.0
Kryptografische Terminal-Forensik und Sitzungswiedergabe für KI-Agenten. Verfolgt, signiert und prüft jeden Befehl mit Herkunftskennzeichnungen, wiederholbaren Sitzungen und Git-Zeitreise. Datenschutzorientiert mit lokaler SQLite-Speicherung und Geheimnis-Redaktion.
Wisse, was lief, wo, wann und wer es ausgeführt hat
Die fehlende Observability-Schicht für KI-gestützte Terminal-Workflows
Signed Provenance
Tracked Sessions
Git Time Travel
Replayable Sessions
IDE style Tab Autocomplete
Agensic rüstet Ihren bestehenden Terminal-Workflow für die KI-Ära auf. Es wurde für Entwickler entwickelt, die den Produktivitätsschub von KI-Agenten direkt in ihrer Shell nutzen möchten, aber keine Kompromisse bei Überprüfbarkeit, Kontrolle und Privatsphäre eingehen wollen.
Da KI-Agenten zunehmend die Befehlszeile übernehmen und Aufgaben autonom ausführen, werden Transparenz und Kontrolle entscheidend. Agensic behandelt Terminal-Befehle als Bürger erster Klasse und bietet ein robustes Framework für deren Nachverfolgung, Inspektion und Verwaltung.
Anstatt die gesamte Terminalaktivität in einer einzigen, mehrdeutigen „Shell-History“ zu vereinen, fungiert Agensic als forensischer Beobachter und intelligenter Co-Pilot. Es verfolgt nahtlos interaktive KI-Codierungssitzungen, signiert von Agenten ausgeführte Befehle kryptografisch und bietet eine blitzschnelle, verlaufsgestützte IDE-artige Tab-Autovervollständigung.
📋 Inhaltsverzeichnis
- Plattform-Unterstützung
- Installation
- Schnellstart
- Agensic Provenance
- Agensic Sessions
- Agensic Autocomplete
- Verfügbare Befehle
- Sicherheit & Datenschutz
- Projektersteller
- Unterstützung
- Lizenz
💻 Plattform-Unterstützung
Agensic ist für eine tiefe Integration in Ihre Shell-Umgebung ausgelegt.
-
macOS (Zsh) – vollständig unterstützt ✅
-
Linux (Bash) – vollständig unterstützt ✅
🚀 Installation
Der schnellste Weg ist der verwaltete Einzeiler-Installer:
curl -fsSL https://raw.githubusercontent.com/Alex188dot/agensic/main/bootstrap.sh | bash
Wenn Sie es lieber manuell klonen möchten:
git clone https://github.com/Alex188dot/agensic.git
cd agensic
bash ./install.sh
Wenn Sie bereits uv haben, wird der Installer es automatisch für eine schnellere Einrichtung verwenden.
Beim ersten Start werden Sie von Agensic aufgefordert, Ihren bevorzugten LLM-Anbieter zu wählen und Ihre API-Schlüssel für die Befehlsautovervollständigung zu konfigurieren.
Alternativ können Sie Ihren LLM-Anbieter und API-Schlüssel durch Ausführen von
agensic setup
konfigurieren.
⚡ Schnellstart
Öffnen Sie nach der Einrichtung ein neues Terminal, und Agensic beginnt automatisch, Ihre Terminalaktivität zu verfolgen und während der Eingabe Vorschläge zur Autovervollständigung zu liefern!
🤖 Nahtlose automatische Agentenverfolgung
Beginnen Sie zu arbeiten wie gewohnt, z. B. mit Ihrem bevorzugten KI-Codierungsassistenten wie Claude Code, Codex CLI usw.:
claude
oder
codex
Eine vollständige Liste aller unterstützten Agenten finden Sie im Abschnitt Unterstützte Agenten. Wenn Ihr Agent nicht in der Liste enthalten ist, können Sie ihn hinzufügen, indem Sie agensic --add_agent "executable" ausführen und ihn dann normal verwenden, damit Agensic ihn verfolgen kann.
Nachdem Sie fertig sind, können Sie mit Agensic den Sitzungsverlauf einsehen:
agensic sessions
oder die forensische Provenienz anzeigen:
agensic provenance
🧾 Agensic Provenance
Agensic liefert ein forensisches Transkript für jeden Befehl. Es klassifiziert, was passiert ist, zeichnet umfangreiche Metadaten auf und präsentiert einen klaren Prüfpfad, sodass Sie erkennen können, ob ein Befehl manuell eingegeben, aus einem Vorschlag übernommen oder direkt von einem Agenten ausgeführt wurde.
✨ Funktionen
🔍 Vollbild-Provenance-Explorer
Müssen Sie beantworten: „Was wurde hier genau ausgeführt und wer hat es ausgelöst?“ Führen Sie agensic provenance aus, um den Vollbild-Provenance-Viewer zu öffnen. Filtern Sie nach Label, Agent, Anbieter oder Zeitfenster, inspizieren Sie die genaue Befehlsspur und exportieren Sie die aktuelle Ansicht bei Bedarf als JSON oder CSV – für Debugging, Incident-Reviews oder Compliance.
🛡️ Kryptografische Befehls-Provenienz & Signierung
Hören Sie auf zu raten, ob ein Mensch oder eine KI den Build zerstört hat. Agensic erfasst für jeden Befehl umfangreiche Metadaten und verwendet lokale Ed25519-Signaturen, um von Agenten ausgeführte Durchläufe mit einem unbestreitbaren AI_EXECUTED-Label zu versehen. Sie erhalten eine klare, überprüfbare Zeitleiste, die menschliche Tastenanschläge von KI-Vorschlägen und automatischen Ausführungen trennt.
🏷️ Strukturierte Attributionslabels
Agensic reduziert die Terminal-History nicht auf eine rohe Liste von Zeichenketten. Jeder verfolgte Befehl wird einem Provenienz-Label zugeordnet, sodass Sie Durchläufe konsistent filtern, Verhalten untersuchen und verstehen können, wie ein Befehl überhaupt in Ihre Shell gelangt ist.
🔖 Unterstützte Labels
Agensic unterstützt derzeit die folgenden Provenienz-Labels:
AI_EXECUTEDfür Befehle, die direkt von einem KI-Agenten ausgeführt wurden, mit signiertem NachweisHUMAN_TYPEDfür Befehle, die von einem Menschen manuell in der Shell eingegeben wurdenAI_SUGGESTED_HUMAN_RANfür Befehle, die von einem externen KI-LLM-Aufruf vorgeschlagen und dann von einem Menschen ausgeführt wurdenAG_SUGGESTED_HUMAN_RANfür Befehle, die von Agensic vorgeschlagen und dann von einem Menschen ausgeführt wurdenINVALID_PROOFfür Befehle, die mit Metadaten eines Nachweises eintrafen, der die Validierung nicht bestanden hatUNKNOWNfür Befehle, bei denen die verfügbaren Beweise nicht ausreichen, um ein stärkeres Attributionslabel zuzuweisen
🕵️♂️ Agensic Sessions
Agensic zeichnet interaktive Agenten-Sitzungen auf und liefert Ihnen einen unbestreitbaren Nachweis darüber, was passiert ist, sowie die Möglichkeit, den Repository-Zustand über die Time-Travel-Funktion sicher zu manipulieren.
