Communitygithub.com

AlexeyKorzhebin/agent-vault-codex-skill

Codex-Fähigkeit und portables CLI für serverseitige Obsidian-Agenten-Vaults.

Was ist agent-vault-codex-skill?

Diese Fähigkeit bietet ein portables Server-CLI für die Interaktion mit einem Obsidian-Agenten-Vault, das speziell für KI-Assistenten wie Codex entwickelt wurde. Sie ermöglicht das Lesen, Schreiben, Durchsuchen und Verwalten von Notizen, Aufgaben und Web-Clippings in einem als Klartext gespeicherten Obsidian-Vault. Durch die Verwendung von SSH für die Kommunikation und Umgebungsvariablen für die Konfiguration bleibt die Fähigkeit flexibel in Bezug auf Server- und Vault-Pfade, ohne Annahmen über die Infrastruktur zu treffen. Sie ist plattformunabhängig und eignet sich daher für jede Entwicklungs- oder KI-Umgebung, in der ein Obsidian-Vault auf einem Remote-Server gehostet wird.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add AlexeyKorzhebin/agent-vault-codex-skill

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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, .git oder _conflicts verwenden.
  • 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 list und gegebenenfalls durch Überprüfung des lokalen Obsidian-Vaults verifizieren.

Verwandte Skills