Agent Vault
サーバーサイドのプレーンテキストObsidianエージェント保管庫を操作するCLIを使用します。このスキルはポータブルです。特定のサーバーや保管庫パスを前提としません。
必要な設定:
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'"
ローカル添付ファイル付きのWebクリップを作成:
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 はMarkdownノートを作成し、画像を隣接の attachments/ フォルダにダウンロードします。相対Markdown画像リンクを使用します。Obsidianクライアントはこれらの添付ファイルを同期してレンダリングします。
安全規則
- パスは常に保管庫ルートからの相対パスにします。
- 絶対パス、
..、.obsidian、.git、_conflictsは使用しないでください。 - Webページは
.htmlファイルではなく、Markdownクリップとローカル添付ファイルとして扱います。 - 重要な書き込み後は、
agent-vault read、agent-vault list、および必要に応じてローカルのObsidian保管庫を確認して同期を検証します。