Communitygithub.com

AlexeyKorzhebin/agent-vault-codex-skill

Codex 技能及可移植的 CLI,用于服务端 Obsidian 代理库。

agent-vault-codex-skill 是什么?

该技能提供了一个可移植的命令行工具,用于操作远程服务器上的纯文本 Obsidian 代理库。它不假设特定的服务器或库路径,而是通过环境变量 `AGENT_VAULT_HOST` 和 `AGENT_VAULT_ROOT` 进行配置。用户可以通过 SSH 远程执行各类操作,包括列出文件、读取笔记、全文搜索、创建或覆盖笔记、追加内容、添加任务以及创建带本地附件的网页剪辑。该工具特别强调路径的安全性——始终使用相对于库根目录的路径,禁止使用绝对路径、`..`、`.obsidian` 等特殊目录。对于重要的写入操作,建议通过 `agent-vault read` 和 `agent-vault list` 验证同步状态。该技能适用于 Claude Code、Cursor 等支持自定义技能的 AI 代理平台,能够无缝集成到开发者的 Obsidian 工作流程中。

兼容平台~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 客户端会同步并渲染这些附件。

安全规则

  • 保持路径相对于库根目录。
  • 切勿使用绝对路径、..、.obsidian、.git 或 _conflicts。
  • 将网页视为 Markdown 剪辑加本地附件,而非 .html 文件。
  • 重要写入后,使用 agent-vault read、agent-vault list 验证同步,必要时检查本地 Obsidian 库。

相关技能