skill-bitwarden/README.md

skill-bitwarden

Skill local de Claude Code para acceder a la cuenta claudecode0 en el Vaultwarden self-hosted del beneficio Rio Frio (vault.nucleoriofrio.com). Read+create vía bw serve local, con guards server-side + script-side.

Este repo es un mirror público del directorio local de la skill que vive en ~/.claude/skills/bitwarden/ en la máquina del usuario humano. Existe para que el usuario humano pueda auditar lo que el bot hace en su cuenta. Clonar y correr en otra máquina no funciona out-of-the-box — requiere bw CLI configurado, master password en .env (no incluido), y los paths absolutos del setup.

Doc principal

Ver SKILL.md — diseño, modelo de seguridad, lifecycle, endpoints. Es la fuente de verdad.

Cheat sheet de endpoints en endpoints.md.

Estructura

.
├── SKILL.md             ← docs canónicas
├── endpoints.md         ← cheat sheet de bw serve REST API
├── .env.example         ← plantilla de config
├── .gitignore
├── README.md            ← este archivo
└── scripts/
    ├── setup.sh         ← one-time/recovery (config server + login + unlock)
    ├── serve-up.sh      ← lanzar bw serve (idempotente)
    ├── serve-down.sh    ← parar bw serve
    └── query.sh         ← helper REST con read+create guard

Lo que NO está en este repo

• .env (master password, API keys del bot)
• .cache/ (session tokens, PIDs, vault encriptado local de bw)

Esos viven solo en la PC del usuario humano.