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
INLINECODE0	Log water intake in milliliters (default: 250ml). Shows running total and goal progress with celebration when goal is reached
INLINECODE1

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: INLINECODE14
• 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

1. 1. Building a daily hydration habit — log each drink throughout the day and let the progress tracker keep you motivated with goal-reached celebrations
2. 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
3. Reviewing weekly trends — run week to see a 7-day summary with emoji indicators showing which days you hit your goal
4. Adjusting your hydration goal — use goal to increase or decrease your daily target based on activity level, weather, or health needs
5. Getting gentle reminders — run remind for evidence-based hydration tips to keep healthy habits top of mind

Examples

CODEBLOCK0

Example Output

CODEBLOCK1

---

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com