NCA Social Media
Erstellt:
Aktualisiert:
Autor:
Roland Golla
OpenWiki Wissenskarte für Entwicklerin und KI Agent

Was ist OpenWiki?

OpenWiki ist ein Open Source CLI Tool von LangChain, das aus deiner Codebase ein verlinktes Markdown Wiki schreibt und aktuell hält. KI Coding Agents lesen dieses Wiki als Kontext und müssen das Repository nicht bei jeder Aufgabe neu erkunden.
Das Wiki liegt als normales Markdown im Ordner openwiki/ deines Repositories. Du kannst es lesen, im Pull Request prüfen und versionieren. Zu jedem Fakt merkt sich OpenWiki die passende Stelle im Code. Ändert sich diese Stelle, weiß das Tool, welche Aussage du prüfen musst.
Neben dem Code Modus gibt es einen Personal Modus. Der baut aus Quellen wie Notion, Gmail oder Git Repositories ein privates Wiki auf deinem Rechner. OpenWiki steht unter MIT Lizenz auf GitHub und läuft auf Deep Agents, dem Agent Framework von LangChain.
Inhalt

OpenWiki mit NCA: Schnelle Hilfe vom Experten

Wir arbeiten täglich mit Coding Agents in PHP, Symfony und Astro Projekten. Das Problem kennen wir gut: Regeln veralten, Doku bleibt liegen und der Agent liest jedes Mal dieselben Dateien. OpenWiki packt genau das an. Wir setzen das Tool noch nicht produktiv ein, ordnen es aber für Teams im eigenen Stack ein.
Beim Vibe Coding Consulting richten wir OpenCode als Coding Agent ein und bringen AGENTS.md und Regeln in eine klare Struktur. Mit den NCA AI Coding Guardrails sichern wir bestehende Projekte ab. Eine gewachsene Codebase prüfen wir im Codebase Audit, und im NCA KI Workshop für Developer lernt dein Team den Umgang mit Agents.
NCA KI Workshop für Developer

Agentic Coding im Team, nicht nur im Glossar

Ein Tag inhouse mit Benjamin Klein für Developer, Tester und Admins. Context Engineering, Harness, ADRs und zwei Hands on Blöcke mit KI Agenten in eurem Setup.

  1. 1
    Kostenloses Vorgespräch
    Stand, Rollen und Ziele klären
  2. 2
    Workshoptag bei euch
    Praxis am Vormittag, Hands on danach
  3. 3
    Praxistag optional
    Agenten im eigenen Projekt
Benjamin Klein
Benjamin Klein
Senior Consultant
Zum Workshop für Developer arrow_forward

Neue Features in OpenWiki

OpenWiki entwickelt sich schnell. Aus dem kleinen CLI für Repository Doku ist ein Werkzeug für mehrere Repos und viele Coding Agents geworden. Diese Neuerungen hebt das Projekt aktuell im README hervor:
  • Wiki Workspaces: Mit openwiki link gruppierst du die Wikis mehrerer Repos. Dein Agent sucht dann über alle hinweg.
  • Mehr Coding Agents: Oh My Pi, Antigravity, IBM Bob und Kiro kommen zu Codex, Claude Code, OpenCode, GitHub Copilot und Cursor dazu.
  • Parallele Page Worker: Die CLI schreibt mehrere Seiten gleichzeitig und bremst bei Rate Limits selbst ab.
  • Fortsetzbare Updates: Fertige Seiten überstehen einen Abbruch. Der nächste Lauf macht dort weiter.
  • Grounded Claims: Fakten verweisen auf versionierte Stellen im Code.

OpenWiki Features im Überblick

Feature Was es macht Dein Nutzen
Grounded Claims Verknüpft Fakten mit versionierten Code Stellen Updates treffen nur, was sich geändert hat
Wiki Workspaces Gruppiert Wikis mehrerer Repos Agents finden Kontext über Repo Grenzen hinweg
Suche per MCP openwiki_search und openwiki_read lesen lokal Agents laden nur passende Abschnitte
Parallele Page Worker Schreibt bis zu 8 Seiten gleichzeitig Große Wikis werden schneller fertig
Visualizer Zeigt das Wiki als Graph mit Markdown Reader Menschen verstehen Zusammenhänge schneller
Open Knowledge Format Schreibt Bundles im Format OKF v0.2 Das Wiki bleibt für andere Tools nutzbar
Mermaid Diagramme Erzeugt und prüft Diagramme aus dem Code Abläufe werden sichtbar, kaputte Diagramme fallen auf

OpenWiki installieren und mit OpenCode nutzen

Der Einstieg dauert wenige Minuten. Du brauchst Node.js ab Version 22.22.0. Am einfachsten startest du im Coding Agent, den du schon nutzt. OpenWiki verwendet dann dessen Modell und Tools, du musst also keinen eigenen Provider einrichten.
Code: 
          
npm install -g openwiki
openwiki integrations install opencode
Danach startest du den Agent neu, öffnest dein Repository und gibst diesen Auftrag:
Code: 
          
Initialize the OpenWiki for this repository from the current source and tests.
Der Agent liest Code und Tests, plant die Seiten und schreibt sie nacheinander nach openwiki/. Wichtige Dateien in diesem Ordner:
  • quickstart.md: der Einstieg für Agents, die das Wiki lesen.
  • INSTRUCTIONS.md: dein Briefing zu Umfang und Prioritäten. OpenWiki liest es und überschreibt es im normalen Lauf nicht.
  • .claims/: die Belege zu den Fakten, sichtbar im Review.
Ohne Agent geht es auch. openwiki --init fragt beim ersten Lauf nach Provider, Zugangsdaten und Modell. Zur Auswahl stehen 14 Provider, darunter OpenAI kompatible Endpunkte wie Ollama. Wenn du lokal arbeiten willst, hilft unser Vergleich der besten Coder Modelle für lokale Nutzung.

Grounded Claims: so bleibt das Wiki aktuell

Generierte Doku hat ein altes Problem: Sie klingt richtig, auch wenn der Code längst anders aussieht. Grounded Claims setzen hier an. Jeder Claim hält einen Fakt fest und zeigt auf eine versionierte Stelle im Code, etwa einen Zeilenbereich in einer Datei.
Vor jedem Update prüft OpenWiki diese Belege. Ändert sich eine Stelle oder fällt sie weg, muss der Fakt bestätigt, neu geschrieben oder entfernt werden. Gibt es nichts zu tun, startet kein Modell und der Inhalt bleibt unberührt. Das spart Tokens und hält den Git Verlauf sauber.
Die Idee passt gut zu Tests als lebende Spezifikation. Beachte aber die Grenze: Claims gelten nur für Repository Wikis und Belege aus dem Repository. Sie zeigen, dass ein Fakt zum Code passt. Ob der Code selbst richtig arbeitet, prüfen weiter deine Quality Gates.

Wiki Workspaces: Kontext über mehrere Repos

Ein Service besteht selten aus nur einem Repo. Backend, Frontend und Infrastruktur liegen oft getrennt. Mit einem Workspace fasst du ihre Wikis unter einem Namen zusammen. Jedes Repo behält dabei sein eigenes Wiki und kann in mehreren Workspaces stecken.
Code: 
          
cd ~/dev
openwiki link
openwiki workspace use payments
Dein Agent nutzt danach zwei Tools: openwiki_search liefert kurze, sortierte Treffer, openwiki_read holt die passenden Abschnitte. Beide lesen nur, arbeiten lokal und rufen kein Modell auf. Das schont das Context Window deines Agents und hilft dir, weniger Tokens zu verbrauchen.

Automatische Updates mit GitHub Actions und GitLab CI

Ein Wiki hilft nur, wenn es aktuell bleibt. OpenWiki liefert dafür fertige Vorlagen für GitHub Actions, GitLab CI und Bitbucket Pipelines. Der geplante Job öffnet einen Pull Request, sobald sich die Doku ändert. So landet das Update in deinem normalen Review und passt in deine CI/CD Pipeline.
Für GitHub gibt es auch eine Vorlage mit Auto Merge. Pflichtchecks und Reviews bestimmen dabei weiter, wann gemerged wird. Halte die Rechte des Tokens klein, pinne alle Versionen und lass Änderungen an Workflow Dateien nie automatisch durch. Versionen hältst du zum Beispiel mit Renovate aktuell.
Läuft die CLI direkt, kannst du mehrere Seiten parallel schreiben lassen. Erlaubt sind Werte von 1 bis 8, das Projekt empfiehlt den Start bei 2 bis 4. Trifft ein Worker auf ein Rate Limit, senkt OpenWiki die Zahl der Worker für den Rest des Laufs.
Code: 
          
OPENWIKI_PAGE_CONCURRENCY=4 openwiki --update

Code Modus und Personal Modus

Der Code Modus ist der Standard. Er dokumentiert das aktuelle Repository und schreibt nach openwiki/. Dazu pflegt er einen eigenen Abschnitt in deiner AGENTS.md. Eine CLAUDE.md aktualisiert er nur, wenn sie schon existiert. Der Rest dieser Dateien bleibt unberührt.
Der Personal Modus baut ein Wiki unter ~/.openwiki/wiki auf. Zu den Quellen gehören Notion, Gmail, Slack, X, Hacker News, Websuche, lokale Git Repos und eigene MCP Server. Für den Zugriff auf interne Systeme lohnt sich ein Blick auf unsere NCA MCP Middleware.
Eine wichtige Einschränkung: Läuft OpenWiki über einen Coding Agent, gibt es nur Repository Wikis. Für den Personal Modus und die Connectors brauchst du die eigenständige CLI. Mit openwiki visualize schaust du dir jedes Wiki zusätzlich als interaktiven Graph an.

OpenWiki, Graphify und AGENTS.md im Vergleich

OpenWiki ist nicht der einzige Weg zu besserem Kontext. Die Ansätze schließen sich nicht aus: Regeln gehören in die AGENTS.md, Wissen über das System ins Wiki, Abhängigkeiten in einen Graph wie Graphify. Für Diagramme gibt es zusätzlich Archify.

Kontext für Coding Agents im Vergleich

Ansatz Was entsteht Passt, wenn
OpenWiki Gepflegtes Markdown Wiki mit Belegen Agent und Team das System verstehen sollen
Graphify Abfragbarer Knowledge Graph Abhängigkeiten und Wege im Code zählen
AGENTS.md von Hand Kurze Regeln für den Agent Vorgaben klar und überschaubar sind
grep und Datei lesen Kein dauerhaftes Artefakt Das Projekt klein ist

Datenschutz: was du vor dem Einsatz prüfen solltest

Das Wiki selbst bleibt bei dir. Dein Code geht aber an das Modell, das du auswählst. Datenschutz entscheidet sich also vor allem beim Provider. Diese Punkte gehören in deine Prüfung für die DSGVO:
  • Telemetrie: Sie ist ab Werk aktiv und anonym. Laut Projekt fließen keine Dateiinhalte, Prompts oder Repo Namen ab. Abschalten geht mit OPENWIKI_TELEMETRY_DISABLED=1 oder DO_NOT_TRACK=1.
  • Visualizer: Der Server läuft nur auf 127.0.0.1, lädt seine Bibliotheken aber von einem öffentlichen CDN.
  • Sensible Pfade: Eine .openwikiignore sperrt Pfade für den Lauf. Inhalte lassen sich aber aus Tests, README oder Commit Texten ableiten.
  • Personal Modus: Mails und Chats landen im Modell, das du eingestellt hast.
Wir arbeiten mit lokalen Development Setups und anonymisierten Daten, etwa mit Faker. Große Coding Modelle kommen aus der Cloud, zum Beispiel über TensorX oder als Enterprise Option über Conversis. Mehr dazu liest du unter digitale Souveränität für Entwickler.

A living wiki for your code, your agents, and you.

OpenWiki README, Open Source Projekt von LangChain unter MIT Lizenz – GitHub langchain-ai/openwiki

OpenWiki im NCA Kontext: gepflegtes Wissen für Agents

Uns gefällt an OpenWiki vor allem die Prüfbarkeit. Das Wiki liegt im Repo, jede Änderung läuft durch einen Pull Request und die Belege lassen sich nachlesen. Das passt zu unserer Haltung bei Agentic Coding: Der Mensch steuert, Regeln prüfen automatisch, der Agent liefert zu.
Ein Wiki ersetzt aber kein Review. Auch ein KI generierter Text kann ein System falsch erklären, ohne dass ein Beleg das sichtbar macht. Lies die ersten Seiten deshalb selbst und schreib in die INSTRUCTIONS.md, was wirklich zählt. Besonders lohnt sich der Einsatz beim Onboarding, bei großen Repos und bei Systemen aus mehreren Services.
Passende Themen dazu: Agentic Coding Patterns für den Workflow, agnostic-ai für eine Konfiguration über mehrere Agents und Headroom für komprimierten Kontext. Bei den Tools ordnen wir auch Claude Code und Codex ein.
CYPRESS.IO Ambassador und IT Consultant für QA Engenieering und Qualität in PHP Projekten.
NCA Vibe Coding Consulting

Roland Golla ist Entwickler aus Leidenschaft – seit über 20 Jahren. Er hat hunderte Projekte begleitet, von Legacy-Refactoring bis KI-Integration. Bei Vibe Coding verbindet er das Beste aus beiden Welten: Die Geschwindigkeit von KI-generiertem Code mit der Qualität professioneller Softwareentwicklung. Kein Bullshit, keine Agentur-Floskeln – direkte Hilfe von jemandem, der selbst täglich im Code steckt.

E-Mail Kontakt

Häufige Fragen zu OpenWiki

Die wichtigsten Antworten zu Funktion, Setup und Datenschutz von OpenWiki.
Was ist OpenWiki 2026?

OpenWiki ist ein Open Source CLI Tool von LangChain. Es schreibt aus deinem Code ein verlinktes Markdown Wiki und hält es aktuell. Coding Agents nutzen dieses Wiki als Kontext und müssen das Repository nicht bei jeder Aufgabe neu erkunden. Menschen können dieselben Seiten lesen oder als Graph erkunden.

Welche neuen Features hat OpenWiki 2026?

Aktuell hebt das Projekt Wiki Workspaces für mehrere Repos, weitere Coding Agent Integrationen und parallele Page Worker hervor. Dazu kommen fortsetzbare Updates und Grounded Claims, die Fakten mit Code Stellen verknüpfen. Auch das portable Format OKF v0.2 und ein veröffentlichbarer Visualizer stehen bereit.

Ist OpenWiki 2026 kostenlos?

Das Tool selbst ist kostenlos und steht unter MIT Lizenz. Kosten entstehen durch das Modell, das die Seiten schreibt. Läuft OpenWiki über deinen Coding Agent, nutzt es dessen Modell Session. Mit der eigenständigen CLI wählst du einen Provider selbst und zahlst dessen Nutzung. Saubere Updates ohne Änderungen rufen kein Modell auf.

Welche Coding Agents unterstützt OpenWiki 2026?

Fertige Integrationen gibt es für Codex, Claude Code, OpenCode, Cursor, IBM Bob, Kiro, Oh My Pi, Antigravity, GitHub Copilot CLI und Pi. Die Installation läuft meist über openwiki integrations install. Sie gilt standardmäßig für deinen Benutzer und funktioniert damit in jedem Git Repository auf deinem Rechner.

Wie installiere ich OpenWiki 2026?

Du brauchst Node.js ab Version 22.22.0. Installiere das Paket mit npm install -g openwiki und verbinde dann deinen Agent, etwa mit openwiki integrations install opencode. Starte den Agent neu, öffne dein Repository und bitte ihn, das OpenWiki aus Code und Tests zu initialisieren. Das Ergebnis landet im Ordner openwiki.

Was sind Grounded Claims?

Grounded Claims sind Fakten aus dem Wiki mit einem Verweis auf eine versionierte Code Stelle. Ändert sich diese Stelle oder fällt sie weg, meldet OpenWiki den betroffenen Fakt. Er wird dann bestätigt, neu geschrieben oder entfernt. So betreffen Updates gezielt die veralteten Aussagen. Claims gelten nur für Repository Wikis.

Was ist ein Wiki Workspace in OpenWiki?

Ein Workspace fasst die Wikis mehrerer Repositories unter einem Namen zusammen. Das hilft, wenn ein Service über mehrere Repos verteilt ist. Dein Agent sucht dann über alle Mitglieder und liest die passenden Abschnitte. Du legst ihn mit openwiki link an. Jedes Repo behält sein eigenes Wiki und kann in mehreren Workspaces sein.

Läuft OpenWiki auch mit lokalen Modellen?

Ja. Über den OpenAI kompatiblen Provider verbindest du Ollama oder LM Studio mit der eigenständigen CLI. Du trägst dafür die Base URL und das Modell ein. Kleine Modelle laufen gut lokal, stoßen bei großen Repos aber schneller an Grenzen. Teste die Qualität deshalb an einem echten Projekt, bevor du dich festlegst.

Ist OpenWiki DSGVO konform einsetzbar?

Das hängt vor allem vom Modell ab, denn dein Code geht an den gewählten Provider. Prüfe zusätzlich die aktive Telemetrie, das CDN im Visualizer und die Connectors im Personal Modus. Mit einem passenden Provider, anonymisierten Daten und klaren Regeln ist der Einsatz möglich. Die rechtliche Bewertung gehört in dein eigenes Datenschutz Team.

Wie halte ich das Wiki automatisch aktuell?

OpenWiki bringt Vorlagen für GitHub Actions, GitLab CI und Bitbucket Pipelines mit. Ein geplanter Job prüft die Änderungen und öffnet bei Bedarf einen Pull Request. Für GitHub gibt es auch eine Variante mit Auto Merge. Im Agent reicht alternativ der Auftrag, das Wiki seit dem letzten erfolgreichen Lauf zu aktualisieren.

Ersetzt OpenWiki die AGENTS.md?

Nein. Die AGENTS.md bleibt der Ort für kurze Regeln und Anweisungen. OpenWiki pflegt dort nur einen eigenen markierten Abschnitt, der auf das Wiki verweist. Der Rest der Datei bleibt unberührt. So bleibt die Datei schlank, und das ausführliche Wissen über dein System liegt in den Seiten des Wikis.

Für welche Projekte lohnt sich OpenWiki?

Am meisten bringt es bei großen Repositories, bei Systemen aus mehreren Services und beim Onboarding neuer Leute. Dort kostet das wiederholte Erkunden des Codes viel Zeit und viele Tokens. Bei kleinen Projekten reichen oft eine gute AGENTS.md und die normale Suche. Starte am besten mit einem Repo und vergleiche das Ergebnis.