Agent Vault
서버 CLI를 사용하여 일반 텍스트 Obsidian 에이전트 볼트를 활용하세요. 이 스킬은 이식 가능하므로 특정 서버나 볼트 경로를 가정하지 않습니다.
필수 구성:
export AGENT_VAULT_HOST=<ssh-host>
export AGENT_VAULT_ROOT=<absolute-vault-root-on-server>
서버의 선택적 바이너리 경로:
export AGENT_VAULT_BIN=${AGENT_VAULT_BIN:-~/.local/bin/agent-vault}
서버에 바이너리가 없으면 번들된 Linux amd64 빌드를 설치합니다:
~/.codex/skills/agent-vault/scripts/install-agent-vault.sh "$AGENT_VAULT_HOST"
원격 CLI 확인:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} help"
사용자가 명시적으로 저수준 디버깅을 요청하지 않는 한 개인 볼트, 비밀 볼트 또는 CouchDB를 직접 건드리지 마세요.
일반 명령어
파일 목록 보기:
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"
노트 읽기:
ssh "$AGENT_VAULT_HOST" "AGENT_VAULT_ROOT='$AGENT_VAULT_ROOT' ${AGENT_VAULT_BIN:-~/.local/bin/agent-vault} read 'web-clips/example/note.md'"
검색:
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"
노트 생성 또는 덮어쓰기:
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'"
노트에 추가:
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'"
작업 추가:
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'"
로컬 첨부 파일이 포함된 웹 클립 생성:
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은 마크다운 노트를 작성하고 이미지를 인접한 attachments/ 폴더에 다운로드합니다. 상대 마크다운 이미지 링크를 사용하세요. Obsidian 클라이언트가 해당 첨부 파일을 동기화하고 렌더링합니다.
안전 규칙
- 경로는 볼트 루트를 기준으로 상대 경로를 유지하세요.
- 절대 경로,
..,.obsidian,.git또는_conflicts를 절대 사용하지 마세요. - 웹 페이지는 HTML 파일이 아닌 마크다운 클립과 로컬 첨부 파일로 취급하세요.
- 중요한 쓰기 작업 후에는
agent-vault read,agent-vault list로 동기화를 확인하고, 필요시 로컬 Obsidian 볼트를 확인하세요.