vaultwarden-cli

name	vaultwarden-cli
description	通过 Bitwarden 官方 bw CLI 安全访问自部署 Vaultwarden。默认只返回脱敏元数据，秘密只进入本机剪贴板。
version	1.0.5

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	锁定密码库并删除本机钥匙串中的临时会话。