Agent Vault
Use a CLI do servidor para um cofre de agente Obsidian em texto simples. A habilidade é portátil: não assuma um servidor ou caminho do cofre específico.
Configuração necessária:
export AGENT_VAULT_HOST=<ssh-host>
export AGENT_VAULT_ROOT=<absolute-vault-root-on-server>
Caminho opcional do binário no servidor:
export AGENT_VAULT_BIN=${AGENT_VAULT_BIN:-~/.local/bin/agent-vault}
Se o binário estiver faltando no servidor, instale a compilação Linux amd64 inclusa:
~/.codex/skills/agent-vault/scripts/install-agent-vault.sh "$AGENT_VAULT_HOST"
Verifique a CLI remota:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} help"
Não mexa em cofres privados, cofres secretos ou CouchDB diretamente, a menos que o usuário peça explicitamente por depuração de baixo nível.
Comandos Comuns
Listar arquivos:
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"
Ler uma nota:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} read 'web-clips/example/note.md'"
Pesquisar:
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"
Criar ou substituir uma nota:
printf '%s\n' '# Título' '' 'Corpo' \
| ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} write --overwrite 'Projects/exemplo.md'"
Anexar a uma nota:
printf '%s\n' 'Novo parágrafo.' \
| ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} append 'Projects/exemplo.md'"
Adicionar uma tarefa:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} task 'Tasks/inbox.md' 'Acompanhar sincronização do servidor'"
Criar um clip da web com anexos locais:
printf '%s\n' '## Resumo' '' '- Ponto chave.' \
| ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} webclip --title 'Título do artigo' --source 'https://exemplo.com' --tags 'web-clip,agentes' --image 'https://exemplo.com/diagrama.png=diagrama.png=Diagrama' 'web-clips/exemplo/artigo.md'"
webclip escreve uma nota Markdown e baixa imagens para uma pasta attachments/ adjacente. Use links de imagem Markdown relativos; clientes Obsidian sincronizam e renderizam esses anexos.
Regras de Segurança
- Mantenha caminhos relativos à raiz do cofre.
- Nunca use caminhos absolutos,
..,.obsidian,.gitou_conflicts. - Trate páginas da web como clipes Markdown mais anexos locais, não arquivos
.html. - Após escritas importantes, verifique a sincronização com
agent-vault read,agent-vault liste, quando necessário, verificando o cofre Obsidian local.