hour-meter

What problem does it solve?

Hour Meter provides a tamper-evident elapsed-time tracker that replaces manual journaling with cryptographic proofs of elapsed time, usable across various life and work scenarios.

Core Features & Use Cases

• Three counting modes: Count Up (time since an event), Count Down (time until a deadline), and Count Between (progress between start and end).
• Tamper-Evident locking: Lock a meter to generate a per-meter hash and a human-readable paper code; optionally export a witness log for offline verification.
• Milestones & notifications: Configure hours or percent milestones and route alerts through Discord, email, or other OpenClaw channels for personal or professional tracking.
• Use cases include sobriety counters, project duration tracking, equipment runtime, career milestones, or any moment worth measuring.

Quick Start

• Create a meter: meter.py create smoke-free --start "2025-06-15" -d "Last cigarette"
• Add milestones: meter.py milestone smoke-free -t hours -v 720 -m "🎉 30 days smoke-free!"
• Lock the meter: meter.py lock smoke-free
• Check status: meter.py check smoke-free
• Verify later: meter.py verify smoke-free "<paper_code>"