totp
oleh diegofcornejo
CLI UtilitiesRingkasan
TOTP-based OTP verification for sensitive operations (env vars, gateway restarts, backup deletions, critical config.
Deskripsi
Apa yang Dilakukan Skill Ini
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.
Kapan Menggunakannya
- 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
Contoh Alur Kerja
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
Persyaratan
- TOTP_SECRET environment variable (Base32 secret generated during setup)
- Google Authenticator, Authy, or any TOTP-compatible authenticator app
Instalasi
clawhub install diegofcornejo/totpJalankan perintah CLI-nya, atau tempel prompt ke Claude Code, Cursor, Codex, atau coding agent apa pun yang Anda pakai.