bitwarden-leaselisted
Install: claude install-skill AntreasAntoniou/bitwarden-lease
# Bitwarden Lease
Use one local macOS broker process to retain `BW_SESSION` in memory for 86,400
seconds. Present the human with a native secure dialog, allow three password
attempts, and share the lease across agent tasks through an owner-only Unix
socket. Never return the Bitwarden session itself.
## Resolve this skill
Set the directory containing this `SKILL.md` before invoking bundled scripts:
```bash
BITWARDEN_LEASE_SKILL="/absolute/path/to/bitwarden-lease"
```
Do not assume whether the active copy is under `~/.agents`, `~/.claude`, or
`~/.codex`; resolve the selected skill path from the available-skills catalog.
## Inspect without prompting
Run:
```bash
"$HOME/.local/bin/bw-lease" status
```
This operation must never open a dialog. Interpret only:
- `status=unlocked`: the broker holds a live lease; use `remaining_seconds`.
- `status=locked`: explicitly unlock before requesting a secret.
- missing socket/client: inspect or install the LaunchAgent.
Do not use `bw status` for this check: brokered `bw` operations intentionally
ensure a lease and may prompt.
## Install or repair
Requirements: macOS, Bitwarden CLI `bw`, and a stable absolute Python 3 path.
Prefer Homebrew Python outside a virtual environment when present.
Validate the package before installation:
```bash
python3 "$BITWARDEN_LEASE_SKILL/scripts/self_test.py"
python3 "$BITWARDEN_LEASE_SKILL/scripts/install_bitwarden_lease_broker.py" \
install --python /opt/homebrew/bin/python3
```
On Intel Hom