Check before you act. Record after. Never do the same thing twice.

Why This Exists

AI agents lose state between sessions. Without a record of what you've already done, you will:

• Reply twice to the same post
• Send duplicate token transfers (unrecoverable on-chain)
• Deploy the same build twice
• Email the same person the same thing

This skill provides a universal dedup layer for any external action.

Quick Start

# Before acting — exits 1 if already done
node scripts/guard.js check  
# After acting — record it
node scripts/guard.js record   [--note "context"] [--parent ]
# Examples
node scripts/guard.js check reply 2033701370289963286
node scripts/guard.js record reply 2033701370289963286 --note "replied to @startupideaspod" --parent 2033500000000000000
node scripts/guard.js check send CPcrV6UeL8CcEvC7rCV6iyUDxbkT5bkJifbz5PUs6zfg
node scripts/guard.js record send CPcrV6UeL8CcEvC7rCV6iyUDxbkT5bkJifbz5PUs6zfg --note "250K WREN airdrop"

Exit Codes

• 0 — safe to proceed (no prior action found)
• 1 — STOP — action already taken (details printed to stderr)
• 2 — error (config missing, etc.)

How It Works

• Check hashes : and searches the log
• Also checks --parent matches — catches "different reply to same post" duplicates
• Record appends to .action-guard/actions.jsonl
• Data persists across sessions — survives context resets

Action Types

Use any string. Common types:

CLI Reference

node scripts/guard.js  [options]
Commands:
  check             Check if action was already taken
  record            Record a completed action
  history [--type ]         Show recent actions
  stats                           Action counts by type
  search                   Search notes
Options:
  --note "text"                   Context note (for record)
  --parent                    Parent/target ID (catches reply-to-same-post dupes)
  --days                       Limit history to N days (default: 30)
  --data-dir                Data directory (default: .action-guard/)

Integration Pattern

In cron jobs or automation, always wrap actions:

BEFORE each action:
  node guard.js check  
  If exit 1 → SKIP (already done)
DO the action
AFTER success:
  node guard.js record   --note "what you did" --parent 

Data Format

Actions stored in .action-guard/actions.jsonl (one JSON object per line):

{"type":"reply","target":"2033701370289963286","parent":"2033500000000000000","note":"replied to @startupideaspod","ts":"2026-03-16T21:30:00.000Z"}

JSONL format means: no parsing the whole file, just append. Fast grep. Easy cleanup.