# skill-bitwarden

Skill local de [Claude Code](https://claude.com/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](SKILL.md)** — diseño, modelo de seguridad, lifecycle,
endpoints. Es la fuente de verdad.

Cheat sheet de endpoints en **[endpoints.md](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.