Anleitung

Der tägliche Ablauf: drei Schritte

Karpathy fasst die tägliche Arbeit mit einer Wissensdatenbank in drei Abläufen zusammen, an denen sich auch die Oberfläche orientiert:

• Ingest – ausarbeiten. Nach dem Import liest der Agent die Quelle, erstellt eine Zusammenfassung, aktualisiert passende Seiten und index.md und ergänzt log.md. Eine Quelle kann Änderungen an vielen Seiten auslösen. „Offen“ bedeutet: Noch keine Wiki-Seite verweist auf eine Quelle unter raw/. Der Hinweis auf der Quellseite sowie die Prüf- und Statistikseiten zeigen solche Quellen an.
• Query – Fragen stellen. „Chat“ in der oberen Leiste öffnet das Seitenpanel. Der Agent liest zuerst index.md, sucht relevante Seiten und antwortet mit Seitenpfaden als Quellenangaben. Antworten können Tabellen, Mermaid-Diagramme oder Marp-Folien enthalten. Wertvolle Antworten kannst du als Seite unter wiki/queries/ speichern. Bei einer Breite von 1280 Pixeln ersetzt der Chat vorübergehend die rechte Seitenleiste.
• Lint – prüfen. „Prüfen“ in der oberen Leiste findet verwaiste Seiten, defekte Links, fehlende Einträge im Index, offene Quellen, fehlerhafte Protokolle sowie fehlende index.md- oder log.md-Dateien. Anschließend kann der Agent – über „Agenten mit einer ausführlichen Prüfung beauftragen“ (lokale KI) oder „Prompt für Cursor kopieren“ (Remote-Agent) – nach Widersprüchen, veralteten Aussagen und fehlenden Konzeptseiten suchen und einen Bericht unter wiki/lint/ ablegen. Die automatische Prüfung zählt nicht als Agent-Auftrag.

Erst besprechen, dann ausarbeiten

Karpathy bevorzugt es, eine Quelle nach der anderen gemeinsam mit dem Agenten zu bearbeiten: erst die wichtigsten Punkte zusammenfassen und besprechen, dann schreiben. Mit einem Remote-Agenten führst du dieses Gespräch einfach in deinem Client, bevor du den Ingest beauftragst. Mit der optionalen lokalen KI funktioniert es so:

1. Öffne eine noch nicht verarbeitete Quellseite und klicke im Hinweis auf „Mit lokaler KI besprechen (optional)“. Im Chat erscheint ein vorbereiteter Prompt: Der Agent soll die Quelle lesen, die Kernaussagen nennen, Bezüge zu vorhandenen Seiten erklären und einen Ablagevorschlag machen.
2. Klicke auf „Senden“. Nachdem der Agent die Quelle und index.md gelesen hat, kannst du ihn lenken: „Der dritte Punkt ist unwichtig“, „Vergleiche das mit Seite X“ oder „Verwende das Format der Argumentationsseite“.
3. Nach der Antwort erscheint über dem Eingabefeld „Wie besprochen ausarbeiten“. Damit startest du den Ingest mit dem gesamten Gespräch als Anweisung. Der Agent erstellt die Zusammenfassung, aktualisiert verwandte Seiten, index.md und log.md.
4. Du kannst die Diskussion überspringen und direkt „Lokal automatisch verarbeiten (optional)“ wählen. Dann arbeitet der Agent die Regeln unter schema/ in einem Durchlauf ab.

Regeln und Vorlagen

Vorlagen. Im Schritt „Wissensgrundlage“ des Einrichtungsassistenten wählst du eine Vorlage – Allgemein, Forschung, Projektmanagement oder Lesen, jeweils auf Deutsch und Englisch – oder startest bewusst leer. Sie besteht aus Regeln unter schema/, Startordnern und einem Einstiegs-Prompt für den Agenten. Sie steuert die Inhalte, nicht die Oberfläche. Unter Einstellungen → „Vorlagen“ kannst du weitere Vorlagen hinzufügen, ohne bestehende Seiten zu überschreiben, Inhalte vorab ansehen, eine Vorlage duplizieren oder deine eigenen Regeln als Vorlage speichern.

index.md und log.md. Die Vorlage legt wiki/index.md und wiki/log.md an. Der Agent aktualisiert sie bei jedem Ingest; Lint prüft, ob sie vorhanden und vollständig sind. index.md ist das Inhaltsverzeichnis mit einem Link und einer Kurzbeschreibung pro Seite. log.md wird nur ergänzt; jeder Eintrag beginnt mit „## [Datum] ingest | Titel“ und hält Ingests, gespeicherte Antworten und Prüfungen fest.

Regeln verfassen. In schema/instructions.md stehen die Arbeitsregeln für den Agenten. Schreibe sie in klarer Sprache und speichere die Seite; beim nächsten Ingest gelten sie. Regeln können für den ganzen Arbeitsbereich oder für General bzw. ein einzelnes Projekt gelten; ein Agent erhält über get_instructions die Ebenen, die er lesen darf. Automatische Ingest-Aufträge können schema/ nicht beschreiben, die Regeln bleiben also in menschlicher Hand. Zum Beispiel:

• „Verfasse Wiki-Seiten auf Deutsch und nenne Fachbegriffe beim ersten Auftreten zusätzlich auf Englisch.“
• „Zusammenfassungen wissenschaftlicher Artikel kommen nach wiki/sources/ und erhalten den citation_key als Dateinamen.“
• „Kennzeichne Widersprüche auf beiden Seiten mit ‚⚠ Widerspruch zu Seite X‘, statt selbst zu entscheiden.“

Der Agent liegt falsch? Kleine Fehler kannst du direkt korrigieren und über „Versionsverlauf“ rückgängig machen. Alternativ korrigierst du den Agenten im Chat und bittest ihn, auch index.md zu aktualisieren. Wiederholt sich derselbe Fehler, halte die Regel in schema/instructions.md fest.

Ansichten und Werkzeuge

• Notizen. Markdown lesen und bearbeiten, mit Live-Vorschau und Speichern über Strg/⌘+S; Bilder lassen sich einfügen oder hineinkopieren. Rechts findest du Rückverweise und Versionen. Jede Version kann angesehen und wiederhergestellt werden.
• Graph. Quellen sind grau, Wiki-Seiten celadonfarben und Regeln bernsteinfarben. Links erstellt der Agent beim Ingest; sie werden nicht automatisch aus Quellen übernommen. Verschiebe Knoten, zoome hinein und spiele die Zeitachse ab. Über „Filtern“ kannst du Ebenen und Ordner auswählen, nach Titeln suchen und verwaiste Seiten ausblenden.
• Tabelle. Listet die Frontmatter-Eigenschaften der Seiten – etwa Autor, Jahr und Tags – auf. Du kannst filtern, sortieren, gruppieren und als CSV kopieren. Die Forschungsvorlage richtet standardmäßig eine Literaturtabelle ein.
• Suche. Die Suche oben vergleicht Teilzeichenfolgen in Titeln und Texten. Sie verwendet dasselbe Suchwerkzeug wie MCP.
• Projekte. Die Projektauswahl wechselt zwischen General und den Projekten, auf die du Zugriff hast. Unter Einstellungen → Projekte legst du Projekte an, bearbeitest, archivierst und stellst sie wieder her. Archivieren behält Notizen und Verlauf, widerruft aber Freigabelinks.
• Teilen. „Teilen“ erstellt einen öffentlichen, schreibgeschützten Link auf genau eine Seite; „Freigabe beenden“ macht ihn sofort ungültig.
• Import. Unter „＋ Neu“ kannst du eine Notiz schreiben, eine URL einfügen, eine Datei hochladen oder Text einfügen. Unterstützt werden PDF, Word, HTML, Markdown, Klartext sowie BibTeX und CSL-JSON. Bei Artikeln werden Autor, Jahr, Zeitschrift und DOI ergänzt. Benötigt eine Webseite JavaScript, wird sie im integrierten Browser geladen. Bot-Schutz oder Anmeldepflicht können den Import verhindern.
• Literatur und Zitate. Schreibe [@citation_key] in eine Wiki-Seite. Das Zitat wird als (Autor, Jahr) dargestellt und mit der Quelle verknüpft; am Ende erscheint automatisch das Literaturverzeichnis. BibTeX und CSL-JSON lassen sich importieren und exportieren.
• Statistik. Zeigt Seiten pro Ebene, Quelltypen, neue Seiten pro Tag, die Bearbeitungsaktivität sowie Agent-Tokens und geschätzte Kosten.

REST-API mit MCP-Zugangsdaten verwenden

Für Skripte, Cronjobs, Claude-Code-Hooks oder andere Programme kannst du MCP-Zugangsdaten aus Einstellungen → „Agent verbinden“ auch als REST-API-Schlüssel nutzen. Sende das Token im Header Authorization: Bearer; Cookie und Origin sind nicht erforderlich. Es gelten dieselben Berechtigungen: Ein Reader darf nur GET-Anfragen senden, Schreiben erfordert einen Librarian mit Schreibrecht für das Ziel. Das Ziel wählst du mit project_key=… oder scope=general; Lesezugriffe akzeptieren auch scope=all, das nur bereits lesbare Inhalte umfasst. Beim Widerruf wird das Token für beide Zugriffswege ungültig; Änderungen werden mcp:<Bezeichnung> zugeordnet. Verwaltungsendpunkte (Mitglieder, Zugangsdaten, Vorlagen, KI-Einstellungen, Chat, Ingest, Prüfung) sind nur nach einer Anmeldung im Browser verfügbar. Die vollständige Referenz steht in docs/rest-api.md.

# Durch die öffentliche URL deiner Installation ersetzen.
APP_URL=https://orakel.marcobartsch.de
# Verzeichnis eines Projekts mit den drei Ebenen und offenen Quellen
curl -H "Authorization: Bearer $TOKEN" "$APP_URL/api/notes/tree?project_key=research"
# Eine Seite in General lesen
curl -H "Authorization: Bearer $TOKEN" "$APP_URL/api/notes?scope=general&path=wiki/index.md"
# Erstellen (201); bei vorhandenem Pfad: 409 (Librarian)
curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"project_key":"research","path":"wiki/notes/idee.md","content":"# Titel\n\nText"}' "$APP_URL/api/notes"
# Aktualisieren (Versionssperre; veraltete Version ergibt 409)
curl -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"project_key":"research","path":"wiki/index.md","content":"...","if_version":3}' "$APP_URL/api/notes"
# Alles durchsuchen, was diese Zugangsdaten lesen dürfen
curl -H "Authorization: Bearer $TOKEN" "$APP_URL/api/search?scope=all&q=Stichwort"
# Eine Quelldatei nach raw/sources/ hochladen (Librarian; das Ziel wird nie erraten)
curl -X POST -H "Authorization: Bearer $TOKEN" -F 'file=@./paper.pdf' "$APP_URL/api/import/file?project_key=research"
# Die lesbaren Inhalte exportieren (ZIP)
curl -H "Authorization: Bearer $TOKEN" -o wiki.zip "$APP_URL/api/export?scope=all"