# Vaultwarden Cli

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

- **Type:** Skill
- **Install:** `agentstack add skill-uvwt-agentdock-vaultwarden-cli`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [uvwt](https://agentstack.voostack.com/s/uvwt)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [uvwt](https://github.com/uvwt)
- **Source:** https://github.com/uvwt/agentdock/tree/main/skill-sources/vaultwarden-cli
- **Website:** https://uvwt.github.io/agentdock-docs/

## Install

```sh
agentstack add skill-uvwt-agentdock-vaultwarden-cli
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 本机终端运行：

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

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

## 可用操作

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

## 调用示例

```json
{"query":"GitHub","limit":10}
```

```json
{"item_id":"条目 ID","field":"password","clear_after_seconds":45}
```

自定义字段：

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

## 辅助脚本执行

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

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

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [uvwt](https://github.com/uvwt)
- **Source:** [uvwt/agentdock](https://github.com/uvwt/agentdock)
- **License:** Apache-2.0
- **Homepage:** https://uvwt.github.io/agentdock-docs/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-uvwt-agentdock-vaultwarden-cli
- Seller: https://agentstack.voostack.com/s/uvwt
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.