alex188dot/agensicKryptografische 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.
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.
Agensic ist für eine tiefe Integration in Ihre Shell-Umgebung ausgelegt.
macOS (Zsh) – vollständig unterstützt ✅
Linux (Bash) – vollständig unterstützt ✅
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.
Ö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!
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 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.
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.
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.
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.
Agensic unterstützt derzeit die folgenden Provenienz-Labels:
AI_EXECUTED für Befehle, die direkt von einem KI-Agenten ausgeführt wurden, mit signiertem NachweisHUMAN_TYPED für Befehle, die von einem Menschen manuell in der Shell eingegeben wurdenAI_SUGGESTED_HUMAN_RAN für Befehle, die von einem externen KI-LLM-Aufruf vorgeschlagen und dann von einem Menschen ausgeführt wurdenAG_SUGGESTED_HUMAN_RAN für Befehle, die von Agensic vorgeschlagen und dann von einem Menschen ausgeführt wurdenINVALID_PROOF für Befehle, die mit Metadaten eines Nachweises eintrafen, der die Validierung nicht bestanden hatUNKNOWN für Befehle, bei denen die verfügbaren Beweise nicht ausreichen, um ein stärkeres Attributionslabel zuzuweisenAgensic 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.
Müssen Sie die letzte nächtliche Sitzung auditieren, um zu verstehen, was passiert ist? Führen Sie agensic sessions aus und wählen Sie die Sitzung aus, die Sie wiederholen möchten. Unser blitzschnelles, vollbildfähiges TUI ermöglicht es Ihnen, sofort Zeitlinien zu durchsuchen, Nutzlasten zu inspizieren und die Sitzung erneut abzuspielen. Wenn Sie Beweise für einen Incident-Review teilen müssen, exportieren Sie den genauen Datensatz mit einem Tastendruck als JSON oder CSV.
Haben Sie sich jemals gefragt: „Wie sah mein Repository genau aus, bevor der Agent diesen destruktiven Commit gemacht hat?“ Time Travel ermöglicht es Ihnen, Ihr Repository auf den genauen Git-Zustand zurückzusetzen, der zu einem bestimmten Sitzungs-Checkpoint aufgezeichnet wurde. Agensic stellt unverfolgte und geänderte Dateien sicher in einem neuen Branch wieder her, sodass Sie bei Untersuchungen niemals versehentlich Ihren Live-Arbeitsbaum zerstören.
Ihre Daten bleiben Ihre Daten. Agensic verwendet ein robustes SQLite-State-Backend mit einem Append-Only-Ereignisprotokoll und automatischer Snapshot-Erstellung. Dadurch überlebt Ihre forensische Historie unerwartete Terminal-Abstürze, Systemneustarts und langlebige lokale Nutzung ohne Datenkorruption.
Agensic bietet Unterstützung für eine Reihe vorkonfigurierter integrierter Agenten, die verfolgt werden können:
Benutzerdefinierte Agenten: Fügen Sie in der Agensic-Einrichtung jede beliebige Agenten-Executable ein, und sie funktioniert sofort ohne Konfiguration.
Agensic erfindet Terminal-Vorschläge neu. Kontextbewusst, semantisch und stets schnell im IDE-Stil – eine zufriedenstellende Tab-Autovervollständigung.
Verabschieden Sie sich von Eingabeverzögerungen. Während Sie tippen, durchsucht Agensic eine Datenbank Ihrer tatsächlichen Befehlshistorie. Vorschläge erscheinen sofort als Ghost-Text, den Sie mit Tab mühelos übernehmen können. Da es aus Ihren Mustern lernt und sich auf das stützt, was Sie tatsächlich tun, sind die Vorschläge äußerst genau und repository-bewusst.
Menschen machen Fehler, Agensic behebt sie. Wenn Sie dokcer eingeben, schlägt Agensic sofort Meinten Sie: docker vor. Können Sie sich nicht an die genaue Syntax erinnern? Semantisches Reranking rettet Ihre Absicht und findet den richtigen Befehl, auch wenn Ihr Präfix nicht perfekt passt: Wenn Sie docker records eingeben, erhalten Sie Meinten Sie: docker logs (vorausgesetzt, Sie haben docker logs in der Vergangenheit ausgeführt).
KI ist ein leistungsstarker Fallback, keine Steuer auf jeden Tastendruck. Agensic erzwingt pro Zeile LLM-Budgets, um Prompt-Spam zu verhindern. Wenn die lokale Historie nicht ausreicht, wird automatisch ein LLM-Fallback ausgelöst. Alternativ können Sie jederzeit Strg+Leertaste drücken, um manuell einen intelligenten Vorschlag von Ihrem bevorzugten lokalen oder gehosteten LLM abzurufen.
Vergessen Sie die genaue Syntax, beschreiben Sie einfach, was Sie wollen. Geben Sie so etwas ein wie: # wie finde ich alle Dateien größer als 10 MB in diesem Ordner?. Agensic generiert 3 kopierfertige Shell-Befehle und fügt die wahrscheinlichste Option direkt in Ihre nächste Zeile ein. Benötigen Sie statt Befehlen eine Anleitung? Verwenden Sie den Assistentenmodus, um schrittweise Antworten direkt in Ihrem Terminal zu erhalten: ## Wie installiere ich Node auf macOS?. Möchten Sie einen Befehl verstehen, bevor Sie ihn ausführen? Verwenden Sie: agensic --explain "Ihr Befehl hier"
Agensic respektiert Ihr Terminal. Es lässt Tab in Ruhe, wenn Sie Dateipfade oder Skripte vervollständigen, sodass die native Shell-Vervollständigung dort gewinnt, wo sie am besten ist. Noch wichtiger: Destruktive Befehle (wie rm -rf, mkfs oder dd) werden strikt aus den Vorschlagslisten ausgeschlossen, sodass Sie niemals versehentlich eine Katastrophe auslösen.
Agensic passt in Ihren Stack, egal ob Sie Modelle lokal oder über gehostete Endpunkte ausführen.
Die folgende Tabelle listet alle derzeit in Agensic verfügbaren CLI-Befehle auf.
Agensic arbeitet nach dem Prinzip der geringsten Rechte und maximalen Privatsphäre:
Alessio Leodori
Finden Sie Agensic nützlich? Geben Sie dem Repo einen Stern ⭐️ und erzählen Sie es einem Freund! Das hilft uns zu wachsen 🌱
Agensic ist Open-Source und unter der Apache-2.0-Lizenz lizenziert.
| Befehl | Beschreibung |
|---|
agensic --help | Zeigt die Haupt-CLI-Hilfe und alle standardmäßigen benutzerorientierten Befehle an |
agensic --version | Gibt die installierte Agensic-Version aus und beendet das Programm |
agensic update | Lädt die neueste veröffentlichte Agensic-GitHub-Version herunter und installiert sie |
agensic setup | Öffnet den interaktiven Einrichtungsablauf für Agensic Sessions und Autocomplete |
agensic enable-startup | Konfiguriert Agensic so, dass es beim Login oder Systemstart automatisch startet |
agensic first-run | Führt den Onboarding-Ablauf bei der Erstinstallation durch |
agensic start | Startet den Agensic-Hintergrunddienst manuell |
agensic stop | Stoppt den Agensic-Dienst |
agensic logs | Zeigt die Dienstprotokollausgabe in Echtzeit an |
agensic test | Sendet eine Test-Autocomplete-Anfrage an den Dienst, um die Verbindung zu überprüfen |
agensic provenance | Öffnet die Befehls-Provenienz-Verlaufsansicht. Unterstützt Filter wie --limit, --label und --contains |
agensic sessions | Öffnet den Browser für verfolgte Sitzungen. Verwenden Sie --text für reine Textausgabe |