sleep-tracker

Health and wellness tracker for logging daily activities, tracking streaks, viewing statistics, setting reminders and goals, and getting health tips. A versatile CLI tool for building and maintaining healthy habits.

Commands

How It Works

INLINECODE13 manages a simple text-based data log (data.log) where each entry is automatically stamped with the current date. It provides a lightweight way to track health activities, build streaks, and review your history.

Daily Workflow

1. 1. Log activities: Record what you did — exercise, meals, sleep times, etc.
2. Check today: Review everything logged today with INLINECODE15
3. Track progress: Use streak to see consecutive days and stats for totals
4. Set goals and reminders: Keep yourself accountable with goal and INLINECODE19
5. Review history: Look at the last 2 weeks with INLINECODE20

Data Storage

All data is stored in $SLEEP_TRACKER_DIR or defaults to ~/.local/share/sleep-tracker/. The directory contains:

• - data.log — main data file with date-stamped entries
• INLINECODE24 — timestamped log of all commands executed for auditing

The tool automatically creates the data directory on first run. You can override the storage location by setting the SLEEP_TRACKER_DIR environment variable.

Requirements

• - Shell: Bash 4+
• No external dependencies — uses only standard Unix utilities (date, grep, wc, tail, cat)
• Works on: Linux, macOS, any POSIX-compatible system

When to Use

1. 1. Daily health logging — Run sleep-tracker log "8h sleep, felt rested" each morning to build a habit history
2. Tracking exercise streaks — Log workouts daily and check sleep-tracker streak to stay motivated with consecutive-day tracking
3. Setting health reminders — Use sleep-tracker reminder "drink water" 14:00 to record reminder notes for key health tasks
4. Reviewing weekly patterns — Run sleep-tracker history to see the last 14 entries and spot trends in your health data
5. Exporting data for analysis — Use sleep-tracker export > health-data.txt to get all records into a file for spreadsheet analysis or sharing with a health professional

Examples

CODEBLOCK0

Health Tips (Built-in)

The tips command provides three core health reminders:

1. 1. Stay hydrated — drink water throughout the day
2. Move every hour — take short breaks from sitting
3. Sleep 7-8 hours — prioritize consistent rest

Configuration

Set the SLEEP_TRACKER_DIR environment variable to change the data directory:

CODEBLOCK1

Default location: INLINECODE38

Output

All output goes to stdout in plain text. Use shell redirection to save results:

CODEBLOCK2