Hydration Tracker

Track daily water intake, set hydration goals, and get drink reminders. Use when logging water, setting targets, or reviewing weekly intake trends.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install hydration-tracker

Hydration Tracker

A daily water intake tracker that helps you build and maintain healthy hydration habits. Log every drink, set personalized daily goals, check your progress throughout the day, and review weekly summaries — all from the command line with local-only data storage.

Commands

Command	Description
`drink [ml]`	Log water intake in milliliters (default: 250ml). Shows running total and goal progress with celebration when goal is reached
`cup`	Quick-log a cup of water (250ml) — shortcut for `drink 250`
`bottle`	Quick-log a bottle of water (500ml) — shortcut for `drink 500`
`today`	Display today's total intake vs. daily goal, with remaining amount or goal-reached indicator
`goal [ml]`	Set your daily hydration goal in milliliters (default: 2000ml)
`check`	Check if you're on track — compares current intake against expected intake based on time of day
`week`	Show a 7-day hydration summary with daily breakdowns, weekly total, and daily average
`history [n]`	Show hydration history for the last N days (default: 7, max: 30)
`stats`	Display overall statistics — total days tracked, total intake, and average daily intake
`remind`	Get a random hydration tip (e.g., "Drink a glass of water before each meal")
`info`	Show version info (v1.0.0)
`help`	Show all available commands with usage examples

Data Storage

Data directory: ~/.water_reminder/
Intake data: data.json — JSON object mapping dates (YYYY-MM-DD) to cumulative daily intake in ml
Goal config: goal.json — stores your current daily goal (default: 2000ml)
Max history: 30 days of lookback for the history command
All data is stored locally in JSON format; no external services, accounts, or network access required

Requirements

Bash 4+
Python 3 (standard library only — used for JSON read/write)
Standard POSIX utilities (date, seq)
No API keys or external dependencies

When to Use

Building a daily hydration habit — log each drink throughout the day and let the progress tracker keep you motivated with goal-reached celebrations
Checking mid-day progress — use check to see if your intake is on track relative to the time of day, so you can catch up before evening
Reviewing weekly trends — run week to see a 7-day summary with emoji indicators showing which days you hit your goal
Adjusting your hydration goal — use goal to increase or decrease your daily target based on activity level, weather, or health needs
Getting gentle reminders — run remind for evidence-based hydration tips to keep healthy habits top of mind

Examples

# Log 300ml of water
hydration-tracker drink 300

# Quick-log a cup (250ml)
hydration-tracker cup

# Quick-log a bottle (500ml)
hydration-tracker bottle

# Check today's progress
hydration-tracker today

# Set a custom daily goal of 2500ml
hydration-tracker goal 2500

Example Output

$ hydration-tracker drink 300
Logged 300ml. Today's total: 1200ml / 2000ml.
Almost there! Keep going!

$ hydration-tracker today
Today's intake (2026-03-18): 1200ml / 2000ml
Remaining: 800ml

$ hydration-tracker week
--- Weekly Hydration Summary ---
2026-03-18: (1200ml / 2000ml) 💧
2026-03-17: (2100ml / 2000ml) 🎉
2026-03-16: (1800ml / 2000ml) 💧
...
Weekly total: 12300ml
Daily average: 1757ml (Goal: 2000ml)

$ hydration-tracker remind
💧 Hydration Tip: Drink a glass of water before each meal.