Communitygithub.com

AlexeyKorzhebin/agent-vault-codex-skill

Habilidade Codex e CLI portátil para cofres de agente Obsidian no lado do servidor.

O que é agent-vault-codex-skill?

Esta skill fornece uma CLI portátil para gerenciar cofres de agente Obsidian em texto simples no lado do servidor. É projetada para ser independente de servidor ou caminho específico, exigindo apenas as variáveis de ambiente `AGENT_VAULT_HOST` e `AGENT_VAULT_ROOT`. A skill suporta operações comuns como listar, ler, pesquisar, criar, substituir, anexar notas, adicionar tarefas e criar clips da web com anexos locais. Ela se integra ao ecossistema Codex (ou Claude Code, Cursor) como uma skill, permitindo que agentes de IA interajam com um cofre Obsidian remoto de forma segura e eficiente, seguindo regras de segurança rigorosas para evitar modificações em caminhos privados ou de sistema. A habilidade também pode instalar automaticamente o binário necessário no servidor se ele não estiver presente.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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, .git ou _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 list e, quando necessário, verificando o cofre Obsidian local.

Habilidades Relacionadas