Agent Vault
Verwenden Sie das Server-CLI für einen Klartext-Obsidian-Agenten-Vault. Die Fähigkeit ist portabel: nehmen Sie keinen spezifischen Server- oder Vault-Pfad an.
Erforderliche Konfiguration:
export AGENT_VAULT_HOST=<ssh-host>
export AGENT_VAULT_ROOT=<absolute-vault-root-on-server>
Optionaler Binärpfad auf dem Server:
export AGENT_VAULT_BIN=${AGENT_VAULT_BIN:-~/.local/bin/agent-vault}
Wenn die Binärdatei auf dem Server fehlt, installieren Sie das gebündelte Linux-amd64-Build:
~/.codex/skills/agent-vault/scripts/install-agent-vault.sh "$AGENT_VAULT_HOST"
Überprüfen Sie das Remote-CLI:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} help"
Berühren Sie keine privaten Vaults, geheimen Vaults oder CouchDB direkt, es sei denn, der Benutzer fordert ausdrücklich Low-Level-Debugging an.
Häufige Befehle
Dateien auflisten:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} list"
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} list web-clips"
Eine Notiz lesen:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} read 'web-clips/example/note.md'"
Suchen:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} search 'Abfragetext'"
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} search 'Abfragetext' Projekte"
Eine Notiz erstellen oder ersetzen:
printf '%s\n' '# Titel' '' 'Textkörper' \
| ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} write --overwrite 'Projekte/beispiel.md'"
An eine Notiz anhängen:
printf '%s\n' 'Neuer Absatz.' \
| ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} append 'Projekte/beispiel.md'"
Eine Aufgabe hinzufügen:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} task 'Aufgaben/eingang.md' 'Server-Synchronisierung nachverfolgen'"
Einen Web-Clip mit lokalen Anhängen erstellen:
printf '%s\n' '## Zusammenfassung' '' '- Wichtiger Punkt.' \
| ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} webclip --title 'Artikeltitel' --source 'https://example.com' --tags 'web-clip,agents' --image 'https://example.com/diagram.png=diagram.png=Diagramm' 'web-clips/beispiel/artikel.md'"
webclip schreibt eine Markdown-Notiz und lädt Bilder in einen benachbarten Ordner attachments/ herunter. Verwenden Sie relative Markdown-Bildlinks; Obsidian-Clients synchronisieren und rendern diese Anhänge.
Sicherheitsregeln
- Pfade immer relativ zum Vault-Stammverzeichnis halten.
- Niemals absolute Pfade,
..,.obsidian,.gitoder_conflictsverwenden. - Webseiten als Markdown-Clips plus lokale Anhänge behandeln, nicht als
.html-Dateien. - Nach wichtigen Schreibvorgängen die Synchronisierung mit
agent-vault read,agent-vault listund gegebenenfalls durch Überprüfung des lokalen Obsidian-Vaults verifizieren.