hydration-tracker

name	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.
version	2.0.0
author	BytesAgain
homepage	https://bytesagain.com
source	https://github.com/bytesagain/ai-skills
tags	["health","hydration","water","reminder","wellness","utility","健康","饮水"]
categories	["Health & Wellness","Utility","Personal Management"]
commands	[{"name":"drink","description":"记录一次饮水量。如不指定，默认为250ml。示例：`water-reminder drink 500`","usage":"hydration-tracker drink [ml]","parameters":[{"name":"ml","type":"number","description":"饮水量，单位毫升。","required":false}]},{"name":"cup","description":"快速记录一杯水（默认为250ml）。","usage":"hydration-tracker cup"},{"name":"bottle","description":"快速记录一瓶水（默认为500ml）。","usage":"hydration-tracker bottle"},{"name":"today","description":"查看今日总饮水量。","usage":"hydration-tracker today"},{"name":"goal","description":"设定每日饮水目标。如不指定，默认为2000ml。示例：`water-reminder goal 2500`","usage":"hydration-tracker goal [ml]","parameters":[{"name":"ml","type":"number","description":"每日饮水目标，单位毫升。","required":false}]},{"name":"check","description":"检查当前饮水进度是否达标。","usage":"hydration-tracker check"},{"name":"week","description":"查看本周饮水量的汇总摘要。","usage":"hydration-tracker week"},{"name":"history","description":"查看最近N天的饮水记录（默认为7天）。示例：`water-reminder history 30`","usage":"hydration-tracker history [n]","parameters":[{"name":"n","type":"number","description":"查看历史记录的天数。","required":false}]},{"name":"stats","description":"显示详细的水合统计数据和趋势。","usage":"hydration-tracker stats"},{"name":"remind","description":"获取水合小贴士和个性化提醒。","usage":"hydration-tracker remind"},{"name":"info","description":"显示Hydration Tracker的版本信息。","usage":"hydration-tracker info"}]
changelog	[{"version":"2.0.0","date":"2026-03-15","changes":["初始版本发布：提供每日饮水追踪、目标设定和进度检查功能。"]}]
pricing_model	free
license	MIT
docs_url	https://bytesagain.com/skills/hydration-tracker
support_url	https://bytesagain.com/feedback

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 command