onirestart · onirestart · Oct 11, 2025 · Oct 11, 2025
diff --git a/minimalist_command_line_habit_tracker/README.md b/minimalist_command_line_habit_tracker/README.md
@@ -0,0 +1,78 @@
+# Minimalist Command-Line Habit Tracker
+
+A simple, lightweight CLI tool to track daily habits with persistent JSON storage.
+
+## Features
+
+- **Add Habits**: Create new habits to track
+- **Check Off Habits**: Mark habits as complete for the current day
+- **List Habits**: View all habits with completion status and history
+- **Persistent Storage**: Data saved in JSON format
+- **Minimalist Interface**: Clean, distraction-free command-line experience
+
+## Installation
+
+1. Clone the repository or download the script
+2. Ensure you have Python 3.x installed
+3. No external dependencies required!
+
+## Usage
+
+### Add a New Habit
+
+```bash
+python minimalist_command_line_habit_tracker.py add "Exercise"
+python minimalist_command_line_habit_tracker.py add "Read for 30 minutes"
+```
+
+### Check Off a Habit for Today
+
+```bash
+python minimalist_command_line_habit_tracker.py check "Exercise"
+python minimalist_command_line_habit_tracker.py check "Read for 30 minutes"
+```
+
+### List All Habits
+
+```bash
+python minimalist_command_line_habit_tracker.py list
+```
+
+Output example:
+```
+📋 Your Habits:
+----------------------------------------
+✓ Exercise (completed 5 times)
+○ Read for 30 minutes (completed 3 times)
+----------------------------------------
+```
+
+## Data Storage
+
+Habits are stored in a `habits.json` file in the same directory as the script. The file contains:
+- List of all habits
+- Completion dates for each habit
+
+## Example Workflow
+
+```bash
+# Day 1: Set up your habits
+python minimalist_command_line_habit_tracker.py add "Morning meditation"
+python minimalist_command_line_habit_tracker.py add "Drink 8 glasses of water"
+python minimalist_command_line_habit_tracker.py add "Write in journal"
+
+# Complete some habits
+python minimalist_command_line_habit_tracker.py check "Morning meditation"
+python minimalist_command_line_habit_tracker.py check "Drink 8 glasses of water"
+
+# Check your progress
+python minimalist_command_line_habit_tracker.py list
+```
+
+## Contributing
+
+Feel free to submit issues, fork the repository, and create pull requests for any improvements.
+
+## License
+
+This project is open source and available under the MIT License.
diff --git a/minimalist_command_line_habit_tracker/minimalist_command_line_habit_tracker.py b/minimalist_command_line_habit_tracker/minimalist_command_line_habit_tracker.py
@@ -0,0 +1,101 @@
+#!/usr/bin/env python3
+"""
+Minimalist Command-Line Habit Tracker
+A simple CLI tool to track daily habits with persistent storage.
+"""
+
+import json
+import os
+from datetime import datetime
+import sys
+
+HABITS_FILE = 'habits.json'
+
+def load_habits():
+    """Load habits from JSON file."""
+    if os.path.exists(HABITS_FILE):
+        with open(HABITS_FILE, 'r') as f:
+            return json.load(f)
+    return {'habits': [], 'completions': {}}
+
+def save_habits(data):
+    """Save habits to JSON file."""
+    with open(HABITS_FILE, 'w') as f:
+        json.dump(data, f, indent=2)
+
+def add_habit(name):
+    """Add a new habit."""
+    data = load_habits()
+    if name not in data['habits']:
+        data['habits'].append(name)
+        save_habits(data)
+        print(f"✓ Added habit: {name}")
+    else:
+        print(f"Habit '{name}' already exists!")
+
+def check_off_habit(name):
+    """Mark a habit as complete for today."""
+    data = load_habits()
+    if name not in data['habits']:
+        print(f"Habit '{name}' not found!")
+        return
+
+    today = datetime.now().strftime('%Y-%m-%d')
+    if name not in data['completions']:
+        data['completions'][name] = []
+
+    if today not in data['completions'][name]:
+        data['completions'][name].append(today)
+        save_habits(data)
+        print(f"✓ Checked off: {name} for {today}")
+    else:
+        print(f"Already completed '{name}' today!")
+
+def list_habits():
+    """List all habits with today's completion status."""
+    data = load_habits()
+    if not data['habits']:
+        print("No habits tracked yet. Add one with: habit add <name>")
+        return
+
+    today = datetime.now().strftime('%Y-%m-%d')
+    print("\n📋 Your Habits:")
+    print("-" * 40)
+
+    for habit in data['habits']:
+        completed_today = habit in data['completions'] and today in data['completions'][habit]
+        status = "✓" if completed_today else "○"
+        total = len(data['completions'].get(habit, []))
+        print(f"{status} {habit} (completed {total} times)")
+
+    print("-" * 40)
+
+def print_usage():
+    """Print usage instructions."""
+    print("\nMinimalist Habit Tracker")
+    print("Usage:")
+    print("  python minimalist_command_line_habit_tracker.py add <habit_name>     - Add a new habit")
+    print("  python minimalist_command_line_habit_tracker.py check <habit_name>   - Check off habit for today")
+    print("  python minimalist_command_line_habit_tracker.py list                 - List all habits\n")
+
+def main():
+    """Main entry point."""
+    if len(sys.argv) < 2:
+        print_usage()
+        return
+
+    command = sys.argv[1].lower()
+
+    if command == 'add' and len(sys.argv) >= 3:
+        habit_name = ' '.join(sys.argv[2:])
+        add_habit(habit_name)
+    elif command == 'check' and len(sys.argv) >= 3:
+        habit_name = ' '.join(sys.argv[2:])
+        check_off_habit(habit_name)
+    elif command == 'list':
+        list_habits()
+    else:
+        print_usage()
+
+if __name__ == '__main__':
+    main()