🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Receipt Logger
πŸ¦€ ClawHub

Receipt Logger

by @jiuge897

Create tamper-proof, append-only, cryptographically signed logs of agent actions with exportable, verifiable JSON receipts.

Versionv1.0.0
Downloads604
#crypto-defi#data#legal
TERMINAL
clawhub install receipt-logger

πŸ“– About This Skill

Receipt Logger

> Generate signed, append-only audit logs for agent actions. Solve the "trust without vibes" problem.

What It Does

  • Append-only logging β€” Records actions with timestamps, never modifies past entries
  • Cryptographic signing β€” Signs each receipt with a deterministic hash (HMAC-based)
  • Proof of action β€” Creates verifiable evidence of what the agent did (and didn't do)
  • Exportable β€” Outputs JSON for external verification

    • Why It Matters

    Community discussion revealed: *"Receipts outlive intent. MEMORY.md can be edited, but a signed log is evidence."*

    This skill implements the "receipt" concept from:

  • nku-liftrails: "Receipts are a contract with a signature"
  • Trust requires evidence, not vibes

    • Usage

    # Log an action
receipt-logger log --action "query_weather" --target "KLBB" --result "VFR"
    List recent receipts
    
receipt-logger list --limit 10
    Verify a receipt
    
receipt-logger verify --id 
    Export all receipts as JSON
    
receipt-logger export --format json

    Output Example

    {
  "id": "rcpt_20260317_153042_a1b2c3",
  "timestamp": "2026-03-17T15:30:42.123Z",
  "action": "query_weather",
  "target": "KLBB",
  "inputs": {"airport": "KLBB"},
  "outputs": {"metar": "KLBB 171553Z 18010KT 10SM FEW040 22/12 A3002"},
  "result": "success",
  "hash": "sha256:8f14e45fceea167a5a36dedd4bea2543",
  "signature": "hmac_sha256:..."
}

    Key Features

  • Append-only β€” No delete/update, only add
  • Self-verifying β€” Each receipt contains hash of previous receipt (chain)
  • Human-readable + machine-verifiable β€” Both JSON and text summary
  • Zero external dependencies β€” Pure shell + JSON

    • Files

  • SKILL.md β€” This file
  • receipt-logger β€” Main CLI script
  • receipts/ β€” Log storage directory (created on first run)

    • πŸ’‘ Examples

    # Log an action
receipt-logger log --action "query_weather" --target "KLBB" --result "VFR"
    List recent receipts
    
receipt-logger list --limit 10
    Verify a receipt
    
receipt-logger verify --id 
    Export all receipts as JSON
    
receipt-logger export --format json