agensic v0.3.0

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

1. Plattform-Unterstützung
2. Installation
3. Schnellstart
4. Agensic Provenance
   • Funktionen
   • Unterstützte Labels
5. Agensic Sessions
   • Funktionen
   • Unterstützte Agenten
6. Agensic Autocomplete
   • Funktionen
   • Unterstützte Anbieter
7. Verfügbare Befehle
8. Sicherheit & Datenschutz
9. Projektersteller
10. Unterstützung
11. 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_EXECUTED für Befehle, die direkt von einem KI-Agenten ausgeführt wurden, mit signiertem Nachweis
• HUMAN_TYPED für Befehle, die von einem Menschen manuell in der Shell eingegeben wurden
• AI_SUGGESTED_HUMAN_RAN für Befehle, die von einem externen KI-LLM-Aufruf vorgeschlagen und dann von einem Menschen ausgeführt wurden
• AG_SUGGESTED_HUMAN_RAN für Befehle, die von Agensic vorgeschlagen und dann von einem Menschen ausgeführt wurden
• INVALID_PROOF für Befehle, die mit Metadaten eines Nachweises eintrafen, der die Validierung nicht bestanden hat
• UNKNOWN fü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.

✨ Funktionen

▶️ Wiederholbare Sitzungen

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.

⏪ Time Travel

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.

🗄️ Widerstandsfähiger lokaler First-State

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.

🤖 Unterstützte Agenten

Agensic bietet Unterstützung für eine Reihe vorkonfigurierter integrierter Agenten, die verfolgt werden können:

• Claude Code
• Codex CLI
• Gemini CLI
• OpenClaw
• OpenCode
• Kimi Code
• Mini Agent
• Qwen Code
• GitHub Copilot CLI
• Kiro CLI
• Cline CLI
• Cursor CLI
• Nanoclaw
• Droid
• Hermes Agent
• Ollama
• Mistral Vibe
• Aider
• Pi.dev
• Kilo Code
• Continue CLI

Benutzerdefinierte Agenten: Fügen Sie in der Agensic-Einrichtung jede beliebige Agenten-Executable ein, und sie funktioniert sofort ohne Konfiguration.

⚡ Agensic Autocomplete

Agensic erfindet Terminal-Vorschläge neu. Kontextbewusst, semantisch und stets schnell im IDE-Stil – eine zufriedenstellende Tab-Autovervollständigung.

✨ Funktionen

🚀 Blitzschnelle lokale Verlaufsvorschläge

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.

🧠 Semantische Suche & Tippfehler-Korrektur

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).

💡 On-Demand KI-Fallback

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.

💬 Natürlichsprachliche Befehlsmodi

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"

🛡️ Native Tab-Erhaltung & Risikoblockierung

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.

🌐 Unterstützte Anbieter

Agensic passt in Ihren Stack, egal ob Sie Modelle lokal oder über gehostete Endpunkte ausführen.

• Lokal: Ollama, LM Studio
• Gehostet: OpenAI, Anthropic, Gemini, Azure, DeepSeek, Groq, Mistral, Qwen (DashScope), MiniMax, Moonshot, OpenRouter, Xiaomi MiMo, Z.AI, AWS SageMaker
• Benutzerdefiniert: jeder OpenAI-kompatible Endpunkt
• Nur Verlauf: komplett offline ohne KI-Aufrufe, nur mit Ihrer lokalen Befehlshistorie

🧰 Verfügbare Befehle

Die folgende Tabelle listet alle derzeit in Agensic verfügbaren CLI-Befehle auf.

🔒 Sicherheit & Datenschutz

Agensic arbeitet nach dem Prinzip der geringsten Rechte und maximalen Privatsphäre:

• Lokale Authentifizierung: Jede localhost-API-Route wird streng mit automatischer Token-Rotation authentifiziert
• Geheimnis-Schwärzung: Werte mit hoher Entropie, URL-Anmeldeinformationen und bekannte Geheimnisformate (wie AWS-Schlüssel oder JWTs) werden bevor Daten Ihr Gerät für einen LLM-Aufruf verlassen, entfernt und geschwärzt
• Befehls-Schutzmaßnahmen: Destruktive Befehle werden sowohl aus der Vorschlagsmaschine als auch aus der Rückkopplungsschleife hart blockiert
• Ratenbegrenzung: Ausgehende LLM-Aufrufe werden durch strenge Timeouts und Budgets begrenzt, um API-Missbrauch zu verhindern

👤 Projektersteller

Alessio Leodori

🤝 Unterstützung

Finden Sie Agensic nützlich? Geben Sie dem Repo einen Stern ⭐️ und erzählen Sie es einem Freund! Das hilft uns zu wachsen 🌱

📄 Lizenz

Agensic ist Open-Source und unter der Apache-2.0-Lizenz lizenziert.