OKF-Bundles in agentische Tools integrieren

Das Muster ist immer dasselbe

Ein OKF-Bundle, das pdf2okf erzeugt, ist ein Verzeichnis einfacher Markdown-Dateien, eine pro Konzept, mit einem Metadaten-Index. Jeder der unten genannten Agenten kann Shell-Befehle ausführen und lokale Dateien lesen. Diese Überschneidung ist die einzige Integration, die du brauchst: Erstelle das Bundle einmal mit pdf2okf convert, zeige einen dieser Agenten auf das Ausgabeverzeichnis, und er beantwortet Fragen aus deinen Dokumenten mit Quellenangaben auf Dateiebene.

Kein Plugin. Kein API-Schlüssel für das Bundle. Kein Custom-Code. Das ist agent-CLI-Dokumenten-Integration ohne Lock-in.

Hermes Agent (Nous Research, MIT)

Hermes Agent ist ein Open-Source-autonomer Agent von Nous Research, veröffentlicht unter der MIT-Lizenz unter github.com/NousResearch/hermes-agent. Er operiert vollständig über die CLI und ist darauf ausgelegt, Shell-Befehle auszuführen, lokale Dateien zu lesen und zu schreiben und in einer agentischen Schleife über deren Inhalte nachzudenken.

Um Hermes Agent mit einem OKF-Bundle zu nutzen, starte ihn mit einer Aufgabe, die auf das Bundle-Verzeichnis zeigt. Hermes durchsucht den Konzept-Ordner, liest passende Dateien und gibt ihre Pfade als Zitate aus. Kein Index, kein Setup: Das Verzeichnis ist die Schnittstelle.

hermes --task "Beantworte Fragen aus dem OKF-Bundle unter ./mein-bundle/concepts/ mit Quellenangaben"

Da Hermes Agent MIT-lizenziert ist und vollständig lokal läuft, verlässt kein Dokumenteninhalt deine Maschine.

Odysseus (PewDiePie, AGPL)

Odysseus ist ein selbst gehosteter, local-first-KI-Workspace von Felix Kjellberg (bekannt als PewDiePie), veröffentlicht unter AGPL unter github.com/pewdiepie-archdaemon/odysseus. Er basiert auf dem Prinzip, dass Modelle, Daten und Workspace auf deiner eigenen Hardware bleiben sollen.

Füge das OKF-Bundle-Verzeichnis als lokale Wissensquelle in Odysseus' Workspace-Konfiguration hinzu. Abfragen laufen direkt gegen diese Markdown-Dateien. Die AGPL-Lizenz gilt nur für Modifikationen, die du verteilst; die private Nutzung auf der eigenen Hardware begründet keine Open-Sourcing-Pflicht.

OpenClaw (Peter Steinberger)

OpenClaw ist Peter Steinbergers selbst gehosteter persönlicher KI-Assistent, veröffentlicht unter github.com/openclaw/openclaw. Er startete als „Clawdbot", wurde in Moltbot umbenannt und anschließend in OpenClaw. Er kapselt ein lokales Modell mit einer Shell-zugänglichen Schnittstelle für dateibasierte Aufgaben.

Lege dein OKF-Bundle-Verzeichnis in einem Pfad ab, auf den OpenClaw zugreifen kann, und referenziere es in einer Abfrage oder einem System-Prompt. Konzeptdateien sind einfaches Markdown; keine Formatkonvertierung ist erforderlich.

Claude Code

Claude Code ist Anthropics agentische CLI für die lokale Arbeit mit Claude. Sie führt eine Agenten-Schleife mit Shell-Zugang und Datei-Lesezugriff aus und unterstützt MCP-Server nativ, was bedeutet, dass sie sich mit dem geplanten MCP-Endpoint von pdf2okf verbinden wird, sobald dieser verfügbar ist.

Bis dahin funktioniert der Dateipfad heute schon:

claude --add-dir ./mein-bundle/

Oder inline im Prompt: "Lies die Dateien in ./mein-bundle/concepts/ und antworte mit Quellenangaben." Claude Code behandelt diese Markdown-Dateien exakt wie jedes andere lokale Wissen.

Cursor

Cursor ist ein KI-nativer Code-Editor mit einem eingebetteten Agenten, der Terminal-Befehle ausführt und Workspace-Dateien liest. Füge das Bundle-Verzeichnis deinem Cursor-Workspace hinzu. Der Agent findet Konzeptdateien über die integrierte Dateisuche und kann sie direkt in seiner Antwort zitieren. Eine zusätzliche Konfiguration ist nicht erforderlich.

Warum selbst gehostete Agenten und souveräne Bundles zusammengehören

Jeder der genannten Agenten (Hermes Agent, Odysseus, OpenClaw, Claude Code, Cursor) ist selbst gehostet, local-first oder beides. Sie teilen dieselbe Kernprämisse wie pdf2okf: Deine Tools laufen auf deiner Hardware, deine Daten bleiben unter deiner Kontrolle.

Wenn du einen selbst gehosteten Agenten mit einem lokal erzeugten und gespeicherten OKF-Bundle kombinierst, entsteht eine vollständig souveräne Pipeline. Das PDF wurde auf deiner Maschine konvertiert. Das Bundle liegt in deinem Dateisystem. Der Agent läuft lokal. Kein Dokumenteninhalt, keine Abfrage, keine Antwort verlässt deine Infrastruktur, es sei denn, du routest explizit zu einem Remote-Modell für komplexe Mehrschritt-Reasoning-Aufgaben über BYOK.

Das ist die Architektur, die DSGVO-regulierte Umgebungen (Anwaltskanzleien, Gesundheitsdienstleister, Behörden) zunehmend fordern. Es ist auch ein besserer Engineering-Standard: schneller, günstiger, auditierbar und offline-fähig ohne besondere Konfiguration.

Das agent-CLI-Dokument-Muster (pdf2okf convert, dann grep) ist die einfachste Version dieser Architektur. Es braucht nichts außer dem, was du bereits hast.

Jetzt loslegen

Erstelle dein erstes Bundle, prüfe die Konzeptdateien und starte den Agenten, den du bereits verwendest, gegen das Bundle-Verzeichnis. Trage dich in die Warteliste auf pdf2okf.com ein, um benachrichtigt zu werden, wenn das CLI verfügbar ist.