Installationsanleitung: Beginnen Sie mit Obsidian. Shared Agent Vault. 48nauts

Warum Nachweise in Obsidian sammeln?

Ein Agentenwechsel sollte nicht bedeuten, jede frühere Entscheidung neu rekonstruieren zu müssen. Die Agent-Vault-Bridge in obsidian-master kopiert unterstützte Gespräche und Notizen. Wenn ein Agent sie benötigt, liefert sie Auszüge mit Quellenverweisen zurück.

Obsidian bietet uns einen Ort, an dem wir diese Dateien lesen, Links folgen und Korrekturen verwalten können. Der Vault ist ein gewöhnlicher Ordner. Python übernimmt die Erfassung und den Abruf, sodass Obsidian nicht geöffnet bleiben muss, damit diese Befehle funktionieren. Dieses Setup erfordert kein Obsidian-Community-Plugin, keinen kostenpflichtigen Synchronisierungsdienst oder keine Obsidian-API.

Dies ist eine Wiederherstellungshilfe, kein Schutzschalter. Es hilft einem Agenten, nach einem Stopp anhand der aufgezeichneten Nachweise fortzufahren. Es erzwingt keine Ausgabenlimits, stoppt keine Tool-Aufrufe und garantiert nicht, dass ein Agent Anweisungen befolgt.

Installieren Sie Obsidian und öffnen Sie einen neuen Vault

Diese Anleitung verwendet macOS wie das installierte Projekt. Laden Sie das macOS-Installationsprogramm von Obsidian, öffnen Sie es und ziehen Sie die App in den Programme-Ordner. Die Offizielle Installationsanleitung beschreibt weitere Plattformen. Der hier gezeigte geplante Betrieb nutzt jedoch macOS launchd.

mkdir -p "$HOME/Knowledge/AgentVault"
open -a Obsidian

Wählen Sie Open folder as vault und danach Knowledge/AgentVault in Ihrem Benutzerordner. Beginnen Sie mit diesem separaten Vault, bevor Sie persönliche Notizen importieren.

Erstellen Sie im Hauptverzeichnis des Vaults die Notiz START.md. Beschreiben Sie kurz, was hier abgelegt werden soll, und verlinken Sie eine neue Notiz unter Knowledge/Recovery rule.md. Fügen Sie dort dieses künstlich erstellte Beispiel ein:

# Recovery rule

After two failed attempts at the same task, stop and record the failed
approach, the evidence and the next proposed test. Ask before restarting.

Dies ist eine Testnotiz, keine automatisch durchgesetzte Richtlinie. Wir werden die gleiche Notiz über alle drei Agenten abrufen.

Halten Sie Notizen, Code und Laufzeitdateien getrennt

~/Knowledge/AgentVault/                 Notes, captured originals, receipts
~/Developer/obsidian-master/             Bridge source and Python environment
~/Library/Application Support/AgentVaultGuide/  Intake config and queue

Auch die Suchdatenbank der Bridge liegt ausserhalb des Vaults. Für die Erfassungskonfiguration nutzen wir AgentVaultGuide, damit die Anleitung keine vorhandene AgentVault-Installation überschreibt. Die nativen Agentensitzungen bleiben an den Speicherorten ihrer Anwendungen.

Konversationsarchive können private Eingabeaufforderungen, Dateiinhalte und Tool-Ausgaben enthalten. Halten Sie den Vault von öffentlichen Git-Repositorys fern. Entscheiden Sie, welche Ordner erfasst werden dürfen, bevor Sie eine Agentenquelle konfigurieren.

Überprüfen Sie dies, bevor Sie fortfahren

Sie sollten START.md und Knowledge/Recovery rule.md sowohl in Obsidian als auch im Finder lesen können. Bisher wurden weder Erfassung, Modellaufrufe noch Hintergrunddienste aktiviert. Als Nächstes können Sie die Bridge installieren und die Testnotiz abrufen.