habit-flow

What This Skill Does

HabitFlow is an AI-powered atomic habit tracker designed for OpenClaw users who want to build consistent routines using natural language. It functions as a personal coach, an automated logger, and a streak tracker. By leveraging evidence-based techniques from James Clear's Atomic Habits, it helps users move beyond simple checklists. The skill integrates with a local configuration system that allows for personalized coaching styles, ranging from a professional data-driven approach to more empathetic or energetic personas like 'Luna' or 'Coach Blaze'. It manages data locally, providing privacy-conscious habit management while still enabling sophisticated features like 1-day streak forgiveness and scheduled WhatsApp reminders.

Installation

To integrate HabitFlow into your OpenClaw environment, ensure you have the OpenClaw agent running and execute the following command in your terminal:

clawhub install openclaw/skills/skills/tralves/habit-flow-skill

Once installed, the skill will initialize its data directory at ~/clawd/habit-flow-data/, where your habit history and persona configurations are stored.

Use Cases

HabitFlow is ideal for users who struggle with the friction of traditional habit tracking apps. Instead of navigating complex interfaces, users can log completions via simple, conversational input. It is best used for:

• Behavioral Change: Establishing new habits by stacking them onto current routines.
• Consistency Tracking: Monitoring streaks and receiving automated nudges if you fall behind.
• Personalized Motivation: Adjusting the AI's tone of voice to match your current emotional or professional needs.
• Reflective Coaching: Asking the AI why you might be failing a habit, allowing it to parse your data for patterns.

Example Prompts

1. "I meditated for 15 minutes today, can you log that and tell me my current streak?"
2. "Switch my persona to 'Luna'—I think I need a more gentle approach to my fitness goals this week."
3. "Remind me to drink water every day at 9 AM, 12 PM, and 6 PM."

Tips & Limitations

• Persona Management: Always ensure your config.json uses the exact IDs provided. If you switch to an unsupported persona, the system will default to 'flex'.
• Natural Language: The parser is robust but performs best with clear temporal references (e.g., 'yesterday', 'Monday').
• Data Privacy: All habit data is stored locally in ~/clawd/, ensuring your personal routines remain under your control.
• Limitations: The 1-day forgiveness streak rule is fixed. If you miss two consecutive days, your streak will reset regardless of the persona active.