human-mode 0.1.0__tar.gz

human_mode-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: human-mode
+Version: 0.1.0
+Summary: A smart CLI tool to remind you to be human
+Author: Sakshi Selmokar
+Dynamic: author
+Dynamic: summary

human_mode-0.1.0/README.md

@@ -0,0 +1,133 @@
+# 🧠 human-mode
+
+A smart CLI tool that reminds you to *actually be human*.
+
+Most reminder apps just spam notifications.
+This one adapts to your behavior.
+
+---
+
+## 🚀 Features
+
+* ⏱️ Smart reminders (`10s`, `5m`, `1h`)
+* 🧠 Activity-aware (won’t interrupt when idle)
+* ⚡ Lightweight & fast (minimal dependencies)
+* 📊 Usage analytics (`human report`)
+* ⚠️ Burnout detection (long work session alerts)
+
+---
+
+## 📦 Installation
+
+```bash
+pip install human-mode
+```
+
+---
+
+## 🛠️ Usage
+
+### ➤ Add a reminder
+
+```bash
+human add "drink water" 30m
+human add "stretch" 1h
+human add "blink" 10s
+```
+
+---
+
+### ➤ Run reminders
+
+```bash
+human run
+```
+
+---
+
+### ➤ View report
+
+```bash
+human report
+```
+
+Example output:
+
+```
+📊 Human Mode Report
+Total reminders: 5
+Active time: 12.5 minutes
+Burnout risk: Low 😊
+```
+
+---
+
+## 💡 Why this exists
+
+I tried multiple reminder apps.
+
+Most of them:
+
+* Required accounts
+* Ran heavy background services
+* Sent annoying notifications
+
+So I built something simple:
+
+* No cloud
+* No accounts
+* Just a CLI tool that adapts to how you work
+
+---
+
+## 🧠 How it works
+
+* Tracks system activity (CPU usage as a proxy)
+* Delays reminders when you're focused
+* Skips reminders when you're idle
+* Tracks usage to generate insights
+
+---
+
+## 📁 Project Structure
+
+```
+human-mode/
+│
+├── human_mode/
+│   ├── cli.py
+│   ├── reminder.py
+│   └── utils.py
+│
+├── setup.py
+├── README.md
+└── requirements.txt
+```
+
+---
+
+## ⚙️ Tech Stack
+
+* Python (stdlib + minimal dependencies)
+* `psutil` (for activity detection)
+
+---
+
+## 🚧 Future Improvements
+
+* Desktop notifications
+* Daily/weekly reports
+* ML-based focus detection
+* Plugin system (Slack, etc.)
+
+---
+
+## 🤝 Contributing
+
+PRs and suggestions are welcome!
+
+---
+
+## ⭐ If you found this useful
+
+Give it a star on GitHub — it helps a lot 🙌

human_mode-0.1.0/human_mode/cli.py

@@ -0,0 +1,36 @@
+import sys
+from human_mode.reminder import add_reminder, run_reminders, show_report
+from human_mode.utils import parse_time
+
+
+def handle_command():
+    args = sys.argv
+
+    if len(args) < 2:
+        print("Usage:")
+        print(" human add <message> <interval>")
+        print(" human run")
+        print(" human report")
+        return
+
+    command = args[1]
+
+    if command == "add":
+        if len(args) < 4:
+            print("Usage: human add <message> <interval>")
+            return
+
+        message = " ".join(args[2:-1])   # ✅ FIXED
+        interval_input = args[-1]
+        interval = parse_time(interval_input)
+
+        add_reminder(message, interval)
+
+    elif command == "run":
+        run_reminders()
+
+    elif command == "report":
+        show_report()
+
+    else:
+        print("Unknown command")

human_mode-0.1.0/human_mode/reminder.py

@@ -0,0 +1,113 @@
+import time
+import json
+import os
+from human_mode.utils import is_user_active
+
+FILE = "reminders.json"
+STATS_FILE = "stats.json"
+
+
+# ---------------- REMINDERS ----------------
+def load_reminders():
+    if not os.path.exists(FILE):
+        return []
+    with open(FILE, "r") as f:
+        return json.load(f)
+
+
+def save_reminders(data):
+    with open(FILE, "w") as f:
+        json.dump(data, f)
+
+
+def add_reminder(message, interval):
+    data = load_reminders()
+    data.append({"message": message, "interval": interval})
+    save_reminders(data)
+    # print(f"Added reminder: {message} every {interval} min")
+    if interval < 1:
+        print(f"Added reminder: {message} every {int(interval*60)} sec")
+    else:
+        print(f"Added reminder: {message} every {interval} min")
+
+# ---------------- STATS ----------------
+def load_stats():
+    if not os.path.exists(STATS_FILE):
+        return {"total_reminders": 0, "active_time": 0}
+    with open(STATS_FILE, "r") as f:
+        return json.load(f)
+
+
+def save_stats(stats):
+    with open(STATS_FILE, "w") as f:
+        json.dump(stats, f)
+
+
+# ---------------- RUN ----------------
+def run_reminders():
+    reminders = load_reminders()
+
+    if not reminders:
+        print("No reminders found")
+        return
+
+    print("Running smart reminders... (Ctrl+C to stop)")
+
+    current_time = time.time()
+    last_trigger = [current_time] * len(reminders)
+    focus_start = current_time
+
+    stats = load_stats()
+
+    while True:
+        current_time = time.time()
+        active = is_user_active()
+
+        for i, r in enumerate(reminders):
+
+            next_time = last_trigger[i] + (r["interval"] * 60)
+
+            if current_time >= next_time:
+
+                if active:
+                    print(f"\n💡 You've been working continuously. {r['message']}?")
+                    stats["total_reminders"] += 1
+                else:
+                    # print(f"\n😴 Skipping (idle): {r['message']}")
+                    last_trigger[i] = current_time
+                    continue
+
+                last_trigger[i] = current_time
+
+        # track active time
+        if active:
+            stats["active_time"] += 5  # loop runs every 5 sec
+
+        save_stats(stats)
+
+        # burnout detection
+        if active and (current_time - focus_start > 7200):
+            print("\n⚠️ You've been working for 2+ hours. Take a break!")
+            focus_start = current_time
+
+        time.sleep(5)
+
+
+# ---------------- REPORT ----------------
+def show_report():
+    stats = load_stats()
+
+    total = stats["total_reminders"]
+    active_time = stats["active_time"] / 60  # seconds → minutes
+
+    if active_time > 120:
+        burnout = "High ⚠️"
+    elif active_time > 60:
+        burnout = "Moderate 😐"
+    else:
+        burnout = "Low 😊"
+
+    print("\n📊 Human Mode Report")
+    print(f"Total reminders: {total}")
+    print(f"Active time: {round(active_time, 2)} minutes")
+    print(f"Burnout risk: {burnout}")

human_mode-0.1.0/human_mode/utils.py

@@ -0,0 +1,36 @@
+import psutil
+import time
+
+# 🔹 Time parsing (for CLI)
+def parse_time(interval_str):
+    """
+    Converts time like:
+    30m -> minutes
+    1h -> minutes
+    45s -> minutes
+    """
+    unit = interval_str[-1]
+    value = int(interval_str[:-1])
+
+    if unit == "s":
+        return value / 60
+    elif unit == "m":
+        return value
+    elif unit == "h":
+        return value * 60
+    else:
+        raise ValueError("Invalid time format. Use s, m, or h.")
+
+
+# 🔹 Activity detection
+def is_user_active(threshold=60):
+    """
+    Checks CPU usage → basic proxy for activity
+    """
+    cpu = psutil.cpu_percent(interval=1)
+    return cpu > 5  # tweak later
+
+
+# (Optional for future use)
+def is_user_idle(last_activity_time, idle_limit=300):
+    return (time.time() - last_activity_time) > idle_limit

human_mode-0.1.0/human_mode.egg-info/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: human-mode
+Version: 0.1.0
+Summary: A smart CLI tool to remind you to be human
+Author: Sakshi Selmokar
+Dynamic: author
+Dynamic: summary

human_mode-0.1.0/human_mode.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+setup.py
+human_mode/__init__.py
+human_mode/cli.py
+human_mode/reminder.py
+human_mode/utils.py
+human_mode.egg-info/PKG-INFO
+human_mode.egg-info/SOURCES.txt
+human_mode.egg-info/dependency_links.txt
+human_mode.egg-info/entry_points.txt
+human_mode.egg-info/top_level.txt

human_mode-0.1.0/human_mode.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

human_mode-0.1.0/human_mode.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+human = human_mode.cli:handle_command

human_mode-0.1.0/human_mode.egg-info/top_level.txt

@@ -0,0 +1 @@
+human_mode

human_mode-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

human_mode-0.1.0/setup.py

@@ -0,0 +1,15 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="human-mode",
+    version="0.1.0",
+    packages=find_packages(),
+    install_requires=[],
+    entry_points={
+        "console_scripts": [
+            "human=human_mode.cli:handle_command"
+        ]
+    },
+    author="Sakshi Selmokar",
+    description="A smart CLI tool to remind you to be human",
+)