Agent Vault
Usa la CLI del servidor para una bóveda de agente Obsidian en texto plano. El skill es portátil: no asumas un servidor o ruta de bóveda específica.
Configuración requerida:
export AGENT_VAULT_HOST=<ssh-host>
export AGENT_VAULT_ROOT=<absolute-vault-root-on-server>
Ruta opcional del binario en el servidor:
export AGENT_VAULT_BIN=${AGENT_VAULT_BIN:-~/.local/bin/agent-vault}
Si el binario no está en el servidor, instala la compilación Linux amd64 incluida:
~/.codex/skills/agent-vault/scripts/install-agent-vault.sh "$AGENT_VAULT_HOST"
Verifica la CLI remota:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} help"
No toques bóvedas privadas, bóvedas secretas o CouchDB directamente a menos que el usuario solicite explícitamente depuración de bajo nivel.
Comandos comunes
Listar archivos:
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"
Leer una nota:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} read 'web-clips/example/note.md'"
Buscar:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} search 'query text'"
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} search 'query text' Projects"
Crear o reemplazar una nota:
printf '%s\n' '# Title' '' 'Body' \
| ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} write --overwrite 'Projects/example.md'"
Añadir a una nota:
printf '%s\n' 'New paragraph.' \
| ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} append 'Projects/example.md'"
Agregar una tarea:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} task 'Tasks/inbox.md' 'Follow up on server sync'"
Crear un recorte web con archivos adjuntos locales:
printf '%s\n' '## Summary' '' '- Key point.' \
| ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} webclip --title 'Article title' --source 'https://example.com' --tags 'web-clip,agents' --image 'https://example.com/diagram.png=diagram.png=Diagram' 'web-clips/example/article.md'"
webclip escribe una nota en Markdown y descarga imágenes en una carpeta attachments/ adyacente. Usa enlaces de imagen Markdown relativos; los clientes Obsidian sincronizan y renderizan esos archivos adjuntos.
Reglas de seguridad
- Mantén las rutas relativas a la raíz de la bóveda.
- Nunca uses rutas absolutas,
..,.obsidian,.gito_conflicts. - Trata las páginas web como clips Markdown más archivos adjuntos locales, no como archivos
.html. - Después de escrituras importantes, verifica la sincronización con
agent-vault read,agent-vault listy, cuando sea necesario, revisando la bóveda Obsidian local.