← Back to Skills Marketplace
Hydration Tracker
by
bytesagain1
· GitHub ↗
· v2.0.1
· MIT-0
315
Downloads
0
Stars
1
Active Installs
9
Versions
Install in OpenClaw
/install hydration-tracker
Description
Track daily water intake, set hydration goals, and get drink reminders. Use when logging water, setting targets, or reviewing weekly intake trends.
README (SKILL.md)
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
historycommand - 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
checkto see if your intake is on track relative to the time of day, so you can catch up before evening - Reviewing weekly trends — run
weekto see a 7-day summary with emoji indicators showing which days you hit your goal - Adjusting your hydration goal — use
goalto increase or decrease your daily target based on activity level, weather, or health needs - Getting gentle reminders — run
remindfor 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.
Powered by BytesAgain | bytesagain.com | [email protected]
Usage Guidance
This appears to be a simple, local-only CLI tool. Before installing: (1) verify you have Bash 4+ and Python 3 available (SKILL.md requires them even though registry metadata didn't list binaries), (2) confirm you are comfortable with the skill creating and writing files under ~/.water_reminder (data.json and goal.json), (3) if you run macOS, test or adjust the date commands (date -d may be incompatible), and (4) review the included script if you want to be certain there are no hidden network calls or data exports (the provided script contains none). The skill requests no credentials and does not require network access.
Capability Analysis
Type: OpenClaw Skill
Name: hydration-tracker
Version: 2.0.1
The Hydration Tracker skill is a legitimate utility for logging water intake with all data stored locally in ~/.water_reminder/. The implementation in scripts/script.sh uses safe practices, such as input validation via regex and passing variables to Python sub-processes through environment variables to prevent shell injection. There are no network calls, obfuscated code, or attempts to access sensitive system files.
Capability Assessment
Purpose & Capability
The skill's name/description match the included script: it logs drinks, manages a goal, and shows summaries stored under ~/.water_reminder. Minor inconsistency: registry metadata lists no required binaries, but SKILL.md and the script require Bash 4+ and Python 3 (standard library). This is expected for a shell-based CLI but should be declared in registry fields.
Instruction Scope
SKILL.md instructions and the script stay within scope: they read/write local files (data.json, goal.json) and run only local commands. There are no network calls, no reading of unrelated files, and no requests for credentials. Minor portability caveat: the script uses GNU date semantics (date -d), which may not work on some platforms (e.g., stock macOS date) without coreutils.
Install Mechanism
No install spec (instruction-only) and the provided script is included directly. No downloads, package installs, or extracted archives are performed by the skill—low install risk.
Credentials
The skill requests no environment variables, no credentials, and stores data locally. This is proportionate to the claimed functionality.
Persistence & Privilege
always:false and user-invocable:true (defaults). The skill writes only to its own data directory (~/.water_reminder) and does not modify other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install hydration-tracker - After installation, invoke the skill by name or use
/hydration-tracker - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.1
update
v2.0.0
v2.5 standard: Use-when desc, homepage, source, security fix
v1.0.6
yaml-fix+quality
v1.0.5
yaml-fix+quality
v1.0.4
Quality upgrade
v1.0.3
Quality upgrade: custom functionality
v1.0.2
Standards compliance: unique content, no template text
v1.0.1
Quality improvement: better docs, examples, cleaner text
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Hydration Tracker?
Track daily water intake, set hydration goals, and get drink reminders. Use when logging water, setting targets, or reviewing weekly intake trends. It is an AI Agent Skill for Claude Code / OpenClaw, with 315 downloads so far.
How do I install Hydration Tracker?
Run "/install hydration-tracker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Hydration Tracker free?
Yes, Hydration Tracker is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Hydration Tracker support?
Hydration Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Hydration Tracker?
It is built and maintained by bytesagain1 (@bytesagain1); the current version is v2.0.1.
More Skills