agentleFS
uvwtuvwt/agentdock-skills/skills/vaultwarden-cli/SKILL.md

vaultwarden-cli

Skill6 starsChanged 2 months agoApache-2.0View on GitHub

通过 Bitwarden 官方 bw CLI 安全访问自部署 Vaultwarden。默认只返回脱敏元数据,秘密只进入本机剪贴板。

The file

Files
SKILL.md

Vaultwarden CLI

该 Skill 不包含第三方 Vaultwarden SDK,也不把密码、TOTP、主密码或 BW_SESSION 返回给模型。

安全边界

  • 唯一的密码库客户端依赖是 Bitwarden 官方包 @bitwarden/cli(命令 bw)。
  • 主密码和两步验证码只由官方 bw CLI 在本机交互式终端读取。
  • 临时会话存放在 macOS 钥匙串,服务名为 agentdock-vaultwarden-cli。
  • search 和 item 只返回脱敏元数据。
  • copy-secret 只写入本机剪贴板,默认 45 秒后在内容未变化时自动清除。
  • 不提供批量导出、批量显示秘密、任意 bw 命令透传或密码库写操作。

首次配置或会话失效

在 DockMini 本机终端运行:

cd "$HOME/AgentDock"
python3 skills/vaultwarden-cli/setup.py

按照官方 bw CLI 的提示输入 Vaultwarden 地址、账号、主密码和两步验证码。

可用操作

  • status:查看 CLI、服务器、登录和安全会话状态。
  • configure-server:配置 Vaultwarden 地址;远程地址强制 HTTPS。
  • sync:同步密码库。
  • search:搜索条目,只返回脱敏元数据。
  • item:读取单条脱敏元数据。
  • copy-secret:复制单个字段到本机剪贴板。
  • lock:锁定密码库并删除钥匙串会话。

调用示例

{"query":"GitHub","limit":10}
{"item_id":"条目 ID","field":"password","clear_after_seconds":45}

自定义字段:

{"item_id":"条目 ID","field":"custom","field_name":"API Key"}

辅助脚本执行

Skill 本体是本说明文档。确需调用包内辅助脚本时,在 Skill 包根目录使用相对路径执行;运行宿主负责切换到包根目录并把所需变量注入当前子进程。

printf '%s' '{"skill_action":"<动作>"}' | python3 run.py

输入必须是 JSON 对象。写操作仍按本文档中的确认规则执行。

动作用途
status检查官方 bw CLI、服务器配置、登录状态和本机安全会话状态,不返回账号或秘密。
configure-server把官方 bw CLI 指向指定的 Vaultwarden HTTPS 地址。
sync使用本机钥匙串中的临时会话同步密码库,不输出秘密。
search搜索密码库并仅返回条目 ID、名称、类型、收藏状态和域名等脱敏元数据。
item按条目 ID 读取脱敏元数据;不会返回密码、TOTP、备注或自定义字段值。
copy-secret把单个密码、用户名、TOTP 或指定自定义字段复制到本机剪贴板;秘密永不进入输出,默认 45 秒后自动清除。
lock锁定密码库并删除本机钥匙串中的临时会话。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.