Communitygithub.com

AlexeyKorzhebin/agent-vault-codex-skill

CodexスキルおよびポータブルCLI。サーバーサイドのObsidianエージェント保管庫を操作します。

agent-vault-codex-skill とは?

Agent Vaultは、サーバー上にあるプレーンテキスト形式のObsidian保管庫を操作するためのポータブルなCLIツールおよびCodexスキルです。特定のサーバーや保管庫パスに依存せず、環境変数 `AGENT_VAULT_HOST` と `AGENT_VAULT_ROOT` で設定可能な柔軟な設計が特徴です。このスキルを使用することで、AIエージェントはSSH経由でリモートのObsidian保管庫に対して、ファイル一覧表示、ノートの読み取り・作成・上書き・追記、検索、タスク追加、Webクリップの作成といった操作を実行できます。特にWebクリップ機能では、Markdownノートの作成と同時に画像を添付フォルダにダウンロードし、相対リンクで参照するため、Obsidianクライアントとの同期がスムーズです。Cody、Codex、Claude CodeなどのAIエージェントプラットフォームで利用でき、セキュリティ上、相対パスの使用や特定ディレクトリへのアクセス禁止といった安全規則が組み込まれています。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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保管庫を確認して同期を検証します。

関連スキル