Communitygithub.com

AlexeyKorzhebin/agent-vault-codex-skill

Codex 스킬 및 서버 측 Obsidian 에이전트 볼트를 위한 이식 가능한 CLI입니다.

agent-vault-codex-skill란 무엇인가요?

이 스킬은 원격 SSH 서버에서 일반 텍스트 Obsidian 볼트와 상호작용할 수 있는 `agent-vault` CLI 도구를 제공합니다. AI 에이전트(예: Codex)가 분산 환경에서도 지식 저장소에 원활하게 접근하고 수정할 수 있도록 설계되었습니다. 주요 기능으로는 파일 목록 보기, 노트 읽기, 콘텐츠 검색, 노트 작성 및 덮어쓰기, 추가하기, 작업 추가, 첨부 파일이 포함된 웹 클립 생성 등이 있습니다. 이 스킬은 마크다운 링크를 통해 이미지를 자동 다운로드하고 첨부 파일을 관리하므로 Obsidian 클라이언트가 동기화하여 올바르게 렌더링할 수 있습니다. 안전 규칙을 준수하여 볼트 루트에 상대적인 경로를 사용하고 민감한 디렉토리(예: `.obsidian`, `.git`, `_conflicts`)에 접근하지 못하도록 하여 데이터 무결성을 보장합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add AlexeyKorzhebin/agent-vault-codex-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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 볼트를 확인하세요.

관련 스킬