om-cli 0.1.0

Advanced Mental Health CLI Platform - Privacy-first wellness toolkit with AI coaching, CBT tools, crisis support, and evidence-based interventions

om 🧘‍♀️

Advanced Mental Health CLI Platform with AI-Powered Wellness

"Mental wellness, compiled locally"

A comprehensive command-line mental health companion featuring evidence-based interventions, AI coaching, and real-time wellness tracking. Built with privacy-first architecture and inspired by leading mental health research.

+-------------------------------------+
|  $ om                               |
|                                     |
|      ╭─╮ ╭─╮                        |
|      │ │ │ │                        |
|      ╰─╯ ╰─╯                        |
|                                     |
|  o breathe o reflect o grow         |
|                                     |
|  your terminal wellness companion   |
+-------------------------------------+

🚀 Quick Install

pip install om-cli

✨ Quick Start

# Start your wellness journey
om qm          # Quick mood check
om qb          # Breathing exercise
om rescue      # Crisis support
om coach daily # AI insights

🧠 Core Features

Evidence-Based Mental Health Tools

• CBT Toolkit - Thought challenging, anxiety management, cognitive distortion detection
• AI Companion - 24/7 conversational support with crisis detection
• Enhanced Chatbot - Therapeutic conversation patterns with om tool integration
• Crisis Support - Immediate access to emergency resources and grounding techniques
• Addiction Recovery - Evidence-based tools for substance abuse recovery (inspired by Try Dry®)
• Body Image Support - Self-acceptance and body positivity tools
• Hypnosis Sessions - Digital hypnosis and guided visualization (inspired by Hypnomatic)

⚡ Ultra-Fast Quick Actions

om qm          # Quick mood check (10 seconds)
om qb          # 4-7-8 breathing exercise (2 minutes)  
om qg          # Gratitude practice (30 seconds)
om qf          # Focus reset (1 minute)
om qc          # Progressive relaxation (90 seconds)
om qcap        # Quick thought capture

🌙 Sleep & Wellness Optimization

• Sleep Cycle Calculator - Optimal bedtimes based on 90-minute cycles
• Sleep Sounds - 18 therapeutic audio tracks for anxiety, ADHD, PTSD
• Positive Psychology - Three Good Things, character strengths, gratitude practices
• Daily Check-ins - Morning and evening wellness routines
• Guided Journals - Therapeutic journaling with structured prompts
• Learning Paths - Structured mental health education modules

🎯 Advanced Analytics & AI

• Enhanced Mood Tracking - 60+ emotions with pattern recognition
• AI Mental Health Coach - Personalized insights and recommendations
• Emotion Analysis - Deep pattern recognition in emotional states
• Smart Suggestions - AI-powered wellness recommendations
• Wellness Dashboard - Real-time progress visualization
• Gamification - Achievement system with 25+ wellness milestones

🌟 Revolutionary Philosophy

Fear as Friend 🐺

Based on Nicky Case's groundbreaking "How to Mental Health" essay:

om wolf        # Talk to your inner anxiety with compassion
om nicky       # Explore 9 evidence-based habits for wellbeing

"Your fear is not your enemy - it's a guard dog for your needs."

🔒 Privacy & Security

100% Local Processing

• ✅ No cloud sync - All data stays on your device
• ✅ No external APIs - Complete offline functionality
• ✅ No tracking - Zero analytics or data collection
• ✅ User controlled - Delete your data anytime

Data Location

~/.om/
├── mood_data.json           # Your emotional journey
├── wellness_stats.json      # Progress tracking
├── ai_conversations.json    # AI companion chats
└── crisis_support.json      # Safety planning (encrypted)

🆘 Crisis Support

Immediate help available 24/7:

om rescue      # Crisis resources and emergency contacts
om qgr         # 5-4-3-2-1 grounding technique

Emergency Resources:

• 🇺🇸 National Suicide Prevention Lifeline: 988
• 🇺🇸 Crisis Text Line: Text HOME to 741741
• 🌍 International crisis resources for 15+ countries

📚 Evidence-Based Foundation

Every feature is backed by peer-reviewed research:

• CBT Techniques - Most researched form of psychotherapy
• Positive Psychology - Martin Seligman's happiness research
• Sleep Science - Circadian rhythm optimization
• AI Mental Health - Digital therapeutics effectiveness studies

🤖 AI-Powered Features

Mental Health Coach

om coach daily     # Get personalized daily insights
om coach analyze   # Deep pattern analysis

Enhanced Chatbot

om chatbot         # Therapeutic conversations with crisis detection

Wellness Autopilot

om autopilot       # Automated wellness task generation

🎮 Gamification & Progress

om gamify status    # View achievements and progress

Achievement Categories:

• 🌱 Mood Tracking milestones
• 🫁 Breathing practice consistency
• 🙏 Gratitude streaks
• 🔥 Daily wellness habits
• 🎯 Crisis recovery support

🌍 Global Impact

Supporting mental health worldwide:

• 🇺🇸 🇬🇧 🇨🇦 🇦🇺 🇩🇪 Crisis resources for 15+ countries
• 🌐 Multi-language support (planned)
• 🏥 Integration with mental health professionals
• 🎓 Educational resources and research backing

🛠️ Installation

Requirements

• Python 3.11+
• 50MB disk space
• Terminal access

Install from PyPI

pip install om-cli

Install from Source

git clone https://github.com/frism/om.git
cd om
pip install -r requirements.txt
python setup.py install

Verify Installation

om --version
om --help
om qm

📖 Complete Documentation

• 📘 Full Documentation - Comprehensive guides
• 🚀 Quick Start - Get started in 5 minutes
• 🧠 CBT Toolkit - Cognitive behavioral therapy tools
• 🤖 AI Companion - AI mental health support
• 🆘 Crisis Support - Emergency resources

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Ways to help:

• 🐛 Report bugs and issues
• 💡 Suggest evidence-based features
• 📝 Improve documentation
• 🌍 Add translations
• 💻 Contribute code

📊 Project Stats

• 47 Python modules with comprehensive mental health features
• 18/19 modules documented (95% coverage)
• 25+ achievements in gamification system
• 15+ countries with crisis support resources
• 60+ emotions in enhanced mood tracking
• 100% privacy-respecting architecture

🏆 Why Choose om-cli?

Feature	om-cli	Headspace	Calm	BetterHelp
Privacy	100% Local	❌ Cloud	❌ Cloud	❌ Cloud
Cost	Free	$12.99/mo	$14.99/mo	$80/week
Crisis Support	✅ Global	❌ None	❌ None	⚠️ Limited
AI Coaching	✅ Personal	❌ None	❌ None	✅ Human
Offline Access	✅ Always	❌ Limited	❌ Limited	❌ None
Data Export	✅ Anytime	❌ None	❌ None	❌ None
Open Source	✅ MIT	❌ Proprietary	❌ Proprietary	❌ Proprietary

💝 Support the Project

If om-cli has helped your mental wellness journey:

Your support helps:

• Keep om-cli free and open source
• Fund new evidence-based features
• Support crisis intervention resources
• Maintain privacy-first development

📄 License & Disclaimer

MIT License - Use, modify, and distribute freely.

Medical Disclaimer: om-cli is a wellness tool designed to complement, not replace, professional mental health care. For mental health emergencies, contact emergency services or crisis hotlines immediately.

🙏 Acknowledgments

Built with love for the mental health community:

• Mental health professionals who provided guidance
• Nicky Case for revolutionary mental health insights
• Open source contributors and beta testers
• The research community for evidence-based interventions

---

🧘‍♀️ Take care of yourself. You deserve wellness and happiness. 🧘‍♂️

PyPI • GitHub • Documentation • Support

Made with ❤️ for mental health and wellness

---

Your mental health journey starts with one command:

pip install om-cli && om qm