Habit Tracker
Track daily habits, build streaks, and get progress reports. Check in with natural language in English or Chinese — no API key required.
# Habit Tracker Track daily habits, build streaks, and get progress reports. Check in with natural language in English or Chinese — no API key required. Habit Tracker helps you build and maintain daily routines by logging check-ins, calculating streaks, and generating weekly or monthly progress reports. It understands natural language in both English and Chinese, so you can say "I ran today", "打卡 运动", or "show my streaks" and it just works — no external services or API keys needed. ## How It Works All data is stored locally in ~/.openclaw/workspace/habits/ as plain JSON files. Each month's check-ins are saved in a separate log file, and your habit definitions live in a central config. On every invocation, the skill detects your intent, routes to the right flow, and updates your local files accordingly. Delivery health checks run automatically to alert you if scheduled reminders have been missed. ## Key Features - **Natural Language Check-In**: Say "I ran today", "drank 8 glasses of water", or "打卡" to log a habit instantly - **Streak Tracking**: Calculates current and best streaks per habit with milestone celebrations at 3, 7, 14, 21, 30, 50, 100, and 365 days - **Today's Dashboard**: View all habits and their completion status for the day at a glance - **Streak Dashboard**: Visual progress bars showing current vs. best streak for every habit - **Weekly & Monthly Reports**: Full completion grids, rates, trends, and actionable tips - **Progress Queries**: Ask "how's my exercise this week?" or "这周运动了几次?" for period-specific stats - **Reminders**: Set per-habit reminder times stored in config; delivery health alerts if pushes are missed - **Bilingual Support**: Mirrors your language (English or Chinese) in all responses - **Safe Deletion**: Removing a habit preserves all historical check-in data - **No API Key Required**: Fully local, no external dependencies ## Requirements - **Local file system access**: Reads and writes to ~/.openclaw/workspace/habits/ - **No external APIs or environment variables**: Works entirely offline ## Use Cases - **Fitness routines**: Track workouts, runs, or gym sessions and celebrate streak milestones - **Health habits**: Log daily water intake, sleep schedules, or meditation sessions - **Learning goals**: Monitor reading, studying, or coding practice with weekly completion rates - **Journaling**: Keep a daily writing habit with streak accountability - **Multi-habit management**: Oversee several habits at once with a unified daily dashboard and weekly report ## Installation Install via: `npx clawhub@latest install habit-tracker`