totp
par diegofcornejo
CLI UtilitiesRésumé
TOTP-based OTP verification for sensitive operations (env vars, gateway restarts, backup deletions, critical config.
Description
Ce que fait ce skill
Adds TOTP-based two-factor verification before an agent executes sensitive operations. Uses otplib with a 2-window tolerance (±1 minute) to handle clock drift. Requires a one-time setup with any TOTP authenticator app.
Enforces a hardware-independent second factor at the agent level without modifying the underlying service or infrastructure.
Quand l'utiliser
- Gating access to .env file contents
- Requiring OTP before restarting a gateway service
- Confirming identity before deleting backups
- Protecting critical config file reads
- Blocking external API key operations without verification
Exemple de workflow
User asks: delete the staging backup
- 1
Agent prompts user for a 6-digit OTP from their authenticator app
- 2
User provides the code
- 3
Agent runs: TOTP_SECRET=$TOTP_SECRET node scripts/verify.js 123456
- 4
Script exits 0 if valid, 1 if invalid or expired
- 5
Agent proceeds with deletion on exit 0, denies on exit 1
Backup deleted after successful OTP verification, or access denied with no action taken
Prérequis
- TOTP_SECRET environment variable (Base32 secret generated during setup)
- Google Authenticator, Authy, or any TOTP-compatible authenticator app
Installation
clawhub install diegofcornejo/totpExécute la commande CLI, ou colle l'instruction dans Claude Code, Cursor, Codex ou l'agent de code que tu utilises.