Communitygithub.com

AlexeyKorzhebin/agent-vault-codex-skill

Codex 技能與可攜式 CLI,用於伺服器端的純文字 Obsidian 代理保險庫

agent-vault-codex-skill 是什麼?

這是一個專為 AI 代理開發者設計的 Codex 技能,提供一個可攜式的命令列介面 (CLI),用於操作位於遠端伺服器上的純文字 Obsidian 保險庫。它無需依賴特定的伺服器或保險庫路徑,只需透過環境變數 `AGENT_VAULT_HOST` 和 `AGENT_VAULT_ROOT` 進行設定即可。此技能支援多種常用操作,包括列出檔案、讀取筆記、執行全文搜尋、建立/取代/附加筆記、新增任務,以及建立附帶本地附件的網頁剪輯。其設計遵循嚴格的安全規則,例如僅使用相對路徑,避免操作 `.obsidian` 等系統檔案,以確保保險庫的完整性。此技能特別適合需要在遠端 Obsidian 保險庫上執行自動化文件管理與知識庫操作的 Claude Code 或 Codex 代理程式。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add AlexeyKorzhebin/agent-vault-codex-skill

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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 會寫入一則 Markdown 筆記,並將圖片下載到相鄰的 attachments/ 資料夾中。請使用相對的 Markdown 圖片連結;Obsidian 客戶端會同步並渲染這些附件。

安全規則

  • 請保持路徑相對於保險庫根目錄(vault root)。
  • 絕不使用絕對路徑、..、.obsidian、.git 或 _conflicts。
  • 將網頁視為 Markdown 剪輯加上本地附件,而不是 .html 檔案。
  • 在重要的寫入操作後,請使用 agent-vault read、agent-vault list 驗證同步,必要時也可檢查本機的 Obsidian 保險庫。

相關技能