hour-meter

Track elapsed time with tamper-evident locking and verification.

2|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/rm289/hour-meter --skill hour-meter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hour-meter
Source: https://github.com/rm289/hour-meter/tree/main
Command: npx skills add https://github.com/rm289/hour-meter --skill hour-meter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

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>"

Frequently Asked Questions about hour-meter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does tamper-evident time tracking work for proving elapsed time?

You create a meter with a start date, add milestones for hours or percentages, then lock it to generate a cryptographic hash and paper code for later verification.

Can I use cryptographic time tracking for sobriety counters and equipment runtime?

Yes, it supports sobriety counters, equipment runtime, project durations, and pregnancy countdowns using count up, count down, or count between modes.

How do I set up milestones and notifications for a time tracking meter?

You configure milestones by specifying hours or percent values, then route alerts through Discord, email, or other OpenClaw channels for tracking notifications.

What do I need to run a local tamper-evident time tracking script?

You need a local environment with a ~/.openclaw/meters.json store to save meter data, per-meter salt for hashing, and optional witness and email integration via included scripts.

How can I export and verify elapsed time logs offline?

You lock a meter to generate a per-meter hash and paper code, then optionally export a witness log for offline verification of elapsed time using included scripts.