Communitygithub.com

AlexeyKorzhebin/agent-vault-codex-skill

Skill de Codex y CLI portátil para bóvedas de agente Obsidian del lado del servidor

¿Qué es agent-vault-codex-skill?

Este skill proporciona una interfaz de línea de comandos portátil para gestionar bóvedas de Obsidian desde un servidor remoto, diseñado específicamente para agentes de IA como Codex. Permite listar, leer, buscar, crear, sobrescribir y añadir contenido a notas, así como gestionar tareas y recortes web con imágenes descargadas. Funciona a través de SSH, manteniendo la bóveda sincronizada y accesible sin intervención manual. Las operaciones se realizan mediante comandos `ssh` que invocan el binario `agent-vault` en el servidor, y se incluyen reglas de seguridad para evitar modificar archivos sensibles o usar rutas absolutas. Es compatible con entornos Obsidian y se puede instalar automáticamente si el binario no está presente.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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, .git o _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 list y, cuando sea necesario, revisando la bóveda Obsidian local.

Skills relacionados