Codex Vault

Codex Vault ist ein lokales Plugin für die Codex-Desktop-App, das Obsidian-kompatible Markdown-Vaults lesen, Notizen durchsuchen, Backlinks und Wissensgraphen anzeigen und ausgewählte Inhalte zum Chat-Kontext hinzufügen kann.

[!IMPORTANT] Das Projekt befindet sich noch in der frühen Entwicklung und wird derzeit nur über den persönlichen Marketplace getestet; eine öffentliche Veröffentlichung steht noch aus.

Funktionen

• Markdown, Wikilinks, Tags und Frontmatter durchsuchen und anzeigen.

• Backlinks, verwaiste Notizen, tote Links und Wissensgraphen anzeigen.

• Ausgewählten Text mit Kommentar zum Codex-Composer hinzufügen; wird nicht automatisch gesendet.

• Mehrere Kommentare sammeln, wobei jeder Kommentar Notizpfad, Text und Zeilennummer behält.

• Notizen sicher über MCP-Tools lesen und schreiben; Schreiben ist standardmäßig deaktiviert.

Related MCP server: vault-master-mcp

Verwendung

Erstelle nach der Installation eine neue Codex-Task, wähle @Codex Vault und gib dann „Vault Explorer öffnen“ ein. Nach einem Plugin-Update muss ebenfalls eine neue Task verwendet werden; bestehende Tasks laden MCP-Tools nicht heiß nach.

Kommentare hinzufügen:

1. Wähle im Markdown-Reader Text aus und klicke auf „Zum Chat hinzufügen“.

2. Gib bei Bedarf einen Kommentar ein und klicke erneut auf „Zum Chat hinzufügen“.

3. Kehre zum Composer zurück und gib deine Frage ein; erst beim Senden wird sie zusammen mit den Kommentaren an das Modell übergeben.

Kommentare existieren nur im Chat-Kontext und werden nicht in Markdown zurückgeschrieben.

Fähigkeitsgrenzen

• Dies ist ein Codex-Plugin und eine MCP-App, kein Fork der Codex-App.

• Es kann nicht als feste Seitenleiste der privaten Codex-UI installiert werden und steuert auch nicht das Modellmenü.

• Kommentare verwenden die öffentliche updateModelContext()-Methode, nicht das private Kommentar-Datenmodell von Codex.

• Derzeit hauptsächlich unter macOS verifiziert; andere Plattformen sind noch nicht vollständig getestet.

Entwicklung

Voraussetzungen: Node.js 22+, Yarn Classic 1.x und eine Codex-App, die Plugins/MCP-Apps unterstützt.

git clone https://github.com/Avery320/codex-vault.git
cd codex-vault
yarn install
yarn build
yarn workspace @foam/mcp test
yarn workspace @foam/graph-view test:unit

In Umgebungen mit eingerichtetem persönlichem Marketplace kann Folgendes ausgeführt werden:

codex plugin add codex-vault@personal
codex plugin list

Die direkte Ausführung von ./scripts/launch_codex_vault_mcp startet nur den Stdio-Server und zeigt keine Codex-UI an. Der vollständige Aktualisierungsablauf ist im Entwicklungsleitfaden beschrieben.

Schreiben

Schreibtools werden nur aktiviert, wenn CODEX_VAULT_ALLOW_WRITES=true gesetzt ist oder der Inhalt von ~/.config/codex-vault/allow-writes true ist.

Zum Ändern einer vorhandenen Notiz muss zuerst preview_resource_update aufgerufen werden, danach update_resource mit der zurückgegebenen SHA-256-Prüfsumme; wenn sich die Datei geändert hat, wird conflict zurückgegeben und der neue Inhalt wird nicht überschrieben.

Dokumentation

• Benutzerhandbuch

• Architektur und Fähigkeitsgrenzen

• Entwicklungsleitfaden

• Sicherheit und lokale Daten

• Fork und Lizenz

Fork und Lizenz

Codex Vault ist aus Foam hervorgegangen, übernimmt dessen Markdown-, Wikilink- und Graph-Kern und ergänzt Codex-Plugin, MCP-App, Multi-Vault-Verwaltung und Chat-Kommentare.

Dieses Projekt steht unter der MIT-Lizenz. Die Namensnennung für Upstream-Quellen, von Microsoft abgeleitete Quellen und Drittanbieter-Abhängigkeiten ist in NOTICE.md aufgeführt. Codex Vault ist kein offizielles Produkt von OpenAI, Obsidian oder Foam.