Complete CLI Reference
======================

This comprehensive reference covers all commands, shortcuts, and aliases available in the om mental health platform.

⚡ Ultra-Fast Quick Actions
--------------------------

Core Quick Actions (q-series)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The q-series commands provide ultra-fast access to essential wellness tools:

.. list-table::
   :header-rows: 1
   :widths: 15 25 35 15

   * - Shortcut
     - Full Command
     - Function
     - Duration
   * - ``om q``
     - ``om quick``
     - Quick actions menu
     - -
   * - ``om qm``
     - ``om quick mood``
     - Mood check with follow-ups
     - 10s
   * - ``om qb``
     - ``om quick breathe``
     - 4-7-8 breathing with visuals
     - 2min
   * - ``om qg``
     - ``om quick gratitude``
     - Gratitude practice
     - 30s
   * - ``om qf``
     - ``om quick focus``
     - Attention reset
     - 1min
   * - ``om qc``
     - ``om quick calm``
     - Progressive relaxation
     - 90s
   * - ``om qr``
     - ``om quick reset``
     - Complete mental reset
     - 2min

🧠 Evidence-Based Features
--------------------------

CBT Toolkit Commands
~~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 30 50

   * - Command
     - Aliases
     - Function
   * - ``om cbt``
     - ``om cognitive``, ``om thoughts``
     - CBT toolkit main menu
   * - ``om cbt challenge``
     - ``om cbt 1``
     - Thought challenging session
   * - ``om cbt anxiety``
     - ``om cbt 2``
     - Anxiety coping strategies
   * - ``om cbt mood``
     - ``om cbt 3``
     - Mood-thought connection tracker
   * - ``om cbt daily``
     - ``om cbt 4``
     - Daily CBT exercise
   * - ``om cbt history``
     - ``om cbt 5``
     - View past thought records

AI Companion Commands
~~~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 30 50

   * - Command
     - Aliases
     - Function
   * - ``om ai``
     - ``om companion``, ``om chat``
     - AI companion main menu
   * - ``om ai chat``
     - ``om ai 1``, ``om talk``
     - Start interactive chat session
   * - ``om ai checkin``
     - ``om ai 2``
     - Personalized check-in
   * - ``om ai suggestions``
     - ``om ai 3``
     - Mood-based suggestions
   * - ``om ai insights``
     - ``om ai 4``
     - Conversation analytics

Sleep Optimization Commands
~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 30 50

   * - Command
     - Aliases
     - Function
   * - ``om sleep``
     - ``om rest``
     - Sleep optimization main menu
   * - ``om sleep wake``
     - ``om sleep 1``
     - Calculate optimal wake times
   * - ``om sleep bedtime``
     - ``om sleep 2``
     - Calculate optimal bedtimes
   * - ``om sleep track``
     - ``om sleep 3``
     - Track sleep quality
   * - ``om sleep hygiene``
     - ``om sleep 4``
     - Sleep hygiene education
   * - ``om sleep analyze``
     - ``om sleep 5``
     - Analyze sleep patterns
   * - ``om sleep nap``
     - ``om nap``, ``om sleep 6``
     - Power nap optimization

Positive Psychology Commands
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 30 50

   * - Command
     - Aliases
     - Function
   * - ``om positive``
     - -
     - Positive psychology main menu
   * - ``om positive three``
     - ``om three``, ``om positive 1``
     - Three Good Things practice
   * - ``om positive gratitude``
     - ``om positive 2``
     - Gratitude letter exercise
   * - ``om positive strengths``
     - ``om strengths``, ``om positive 3``
     - Character strengths identification
   * - ``om positive emotions``
     - ``om positive 4``
     - Positive emotion cultivation
   * - ``om positive best``
     - ``om positive 5``
     - Best possible self exercise
   * - ``om positive optimism``
     - ``om optimism``, ``om positive 6``
     - Optimism training
   * - ``om positive dashboard``
     - ``om positive 7``
     - Practice summary dashboard

Nicky Case Guide Commands
~~~~~~~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 30 50

   * - Command
     - Aliases
     - Function
   * - ``om nicky``
     - ``om guide``
     - Nicky Case guide main menu
   * - ``om nicky guide``
     - ``om nicky 1``
     - Read the full "fear as friend" philosophy
   * - ``om nicky habits``
     - ``om habits``, ``om nicky 2``
     - Explore 9 evidence-based habits
   * - ``om nicky wolf``
     - ``om wolf``, ``om fear``, ``om nicky 3``
     - Talk to your inner wolf (anxiety)
   * - ``om nicky dashboard``
     - ``om nicky 4``
     - Track habit formation progress
   * - ``om nicky wisdom``
     - ``om nicky 5``
     - Daily wolf wisdom and insights
   * - ``om nicky integration``
     - ``om nicky 6``
     - See connections with om features

🎯 Core Mental Health Commands
------------------------------
     - 1min
   * - ``om qa``
     - ``om quick affirmation``
     - Positive self-talk
     - 30s
   * - ``om qgr``
     - ``om quick grounding``
     - 5-4-3-2-1 technique
     - 1-2min
   * - ``om qch``
     - ``om quick checkin``
     - Complete wellness check
     - 1min
   * - ``om qbox``
     - ``om quick box``
     - Box breathing for focus
     - 1min

🧠 Core Mental Health Functions
-------------------------------

Mood & Tracking
~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Shortcut
     - Alternatives
     - Function
   * - ``om m``
     - ``om mood``, ``om mt``, ``om track``
     - Comprehensive mood tracking
   * - ``om mood add``
     - ``om m add``, ``om track mood``
     - Add new mood entry
   * - ``om mood show``
     - ``om m show``, ``om mood list``
     - Show recent mood entries
   * - ``om mood stats``
     - ``om m stats``, ``om mood analytics``
     - Mood statistics and patterns

Breathing & Meditation
~~~~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Shortcut
     - Alternatives
     - Function
   * - ``om b``
     - ``om breathe``, ``om br``, ``om breath``
     - Breathing exercises menu
   * - ``om b 478``
     - ``om breathe 478``
     - 4-7-8 breathing technique
   * - ``om b box``
     - ``om breathe box``
     - Box breathing (4-4-4-4)
   * - ``om med``
     - ``om meditation``, ``om zen``
     - Enhanced meditation sessions

Gratitude & Positivity
~~~~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Shortcut
     - Alternatives
     - Function
   * - ``om g``
     - ``om grat``, ``om thanks``, ``om appreciate``
     - Gratitude practice
   * - ``om g add``
     - ``om gratitude add``
     - Add gratitude entry
   * - ``om g show``
     - ``om gratitude show``
     - Show gratitude history

Physical Wellness
~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Shortcut
     - Alternatives
     - Function
   * - ``om s``
     - ``om stretch``, ``om physical``
     - Physical wellness menu
   * - ``om s back``
     - ``om stretch back``
     - Back stretching routine
   * - ``om s hands``
     - ``om stretch hands``
     - Hand and wrist exercises
   * - ``om s neck``
     - ``om stretch neck``
     - Neck tension relief

Habits & Routines
~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Shortcut
     - Alternatives
     - Function
   * - ``om h``
     - ``om habits``, ``om track``, ``om routine``
     - Habit tracking system
   * - ``om h add``
     - ``om habits add``
     - Add new habit
   * - ``om h check``
     - ``om habits check``
     - Mark habit as complete
   * - ``om h stats``
     - ``om habits stats``
     - Habit statistics

🆘 Mental Health Support
------------------------

Anxiety & Panic
~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Shortcut
     - Alternatives
     - Function
   * - ``om anx``
     - ``om anxiety``, ``om panic``, ``om worry``
     - Anxiety support tools
   * - ``om anx breathe``
     - ``om anxiety breathing``
     - Anxiety-specific breathing
   * - ``om anx ground``
     - ``om anxiety grounding``
     - Grounding techniques
   * - ``om anx cope``
     - ``om anxiety coping``
     - Coping strategies

Depression & Mood
~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Shortcut
     - Alternatives
     - Function
   * - ``om dep``
     - ``om depression``, ``om low``, ``om down``
     - Depression support
   * - ``om dep activities``
     - ``om depression behavioral``
     - Behavioral activation
   * - ``om dep thoughts``
     - ``om depression cognitive``
     - Cognitive restructuring
   * - ``om dep support``
     - ``om depression resources``
     - Support resources

Crisis & Emergency
~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Shortcut
     - Alternatives
     - Function
   * - ``om resc``
     - ``om rescue``, ``om crisis``, ``om emergency``
     - Crisis support resources
   * - ``om resc now``
     - ``om rescue immediate``
     - Immediate crisis help
   * - ``om resc plan``
     - ``om rescue safety``
     - Safety planning
   * - ``om resc contacts``
     - ``om rescue resources``
     - Emergency contacts

Sleep & Insomnia
~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Shortcut
     - Alternatives
     - Function
   * - ``om sleep``
     - ``om insomnia``, ``om rest``
     - Sleep support tools
   * - ``om sleep hygiene``
     - ``om sleep habits``
     - Sleep hygiene tips
   * - ``om sleep relax``
     - ``om sleep meditation``
     - Sleep relaxation
   * - ``om sleep track``
     - ``om sleep log``
     - Sleep tracking

Coping & Strategies
~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Shortcut
     - Alternatives
     - Function
   * - ``om cope``
     - ``om coping``, ``om strategies``
     - Coping strategies menu
   * - ``om cope dbt``
     - ``om coping dbt``
     - DBT skills
   * - ``om cope mindful``
     - ``om coping mindfulness``
     - Mindfulness techniques
   * - ``om cope distract``
     - ``om coping distraction``
     - Distraction techniques

🤖 AI-Powered Features
----------------------

AI Mental Health Coach
~~~~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Command
     - Alternatives
     - Function
   * - ``om coach``
     - ``om ai``, ``om assistant``
     - AI coaching menu
   * - ``om coach daily``
     - ``om ai daily``
     - Daily personalized guidance
   * - ``om coach analyze``
     - ``om ai analyze``
     - Deep pattern analysis
   * - ``om coach urgent``
     - ``om ai urgent``
     - Priority mental health alerts
   * - ``om coach summary``
     - ``om ai summary``
     - Coaching effectiveness summary

Wellness Autopilot
~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Command
     - Alternatives
     - Function
   * - ``om autopilot``
     - ``om auto``, ``om pilot``
     - Autopilot system menu
   * - ``om autopilot tasks``
     - ``om auto tasks``
     - View wellness tasks
   * - ``om autopilot recommendations``
     - ``om auto recs``
     - Get AI recommendations
   * - ``om autopilot complete 1 8``
     - ``om auto done 1 8``
     - Complete task with rating
   * - ``om autopilot config``
     - ``om auto settings``
     - Configure autopilot

Gamification System
~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Command
     - Alternatives
     - Function
   * - ``om gamify``
     - ``om game``, ``om achieve``
     - Gamification menu
   * - ``om gamify status``
     - ``om game status``
     - View progress & level
   * - ``om gamify achievements``
     - ``om game unlocked``
     - See unlocked achievements
   * - ``om gamify challenge``
     - ``om game daily``
     - Daily wellness challenge
   * - ``om gamify leaderboard``
     - ``om game stats``
     - Personal stats leaderboard

📊 Visual Dashboard
-------------------

Dashboard Commands
~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Command
     - Alternatives
     - Function
   * - ``om dashboard``
     - ``om d``, ``om dash``
     - Dashboard menu
   * - ``om dashboard show``
     - ``om d show``
     - Static wellness overview
   * - ``om dashboard live``
     - ``om d live``
     - Live updating dashboard
   * - ``om dashboard summary``
     - ``om d summary``
     - Quick wellness summary
   * - ``om dashboard export``
     - ``om d export``
     - Export wellness data

Visual Mode
~~~~~~~~~~~

Add ``-v`` flag for beautiful visual interfaces:

.. code-block:: bash

   om gamify status -v       # 🎨 Stunning achievements gallery
   om dashboard -v           # 📊 Rich visual dashboard
   om coach analyze -v       # 🧠 Interactive AI analysis

✨ Positive Affirmations
------------------------

Affirmations Commands
~~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Command
     - Alternatives
     - Function
   * - ``om affirmations``
     - ``om affirm``, ``om positive``, ``om inspire``
     - Daily affirmation
   * - ``om affirmations daily``
     - ``om affirm daily``
     - Get daily affirmation
   * - ``om affirmations random``
     - ``om affirm random``
     - Get random affirmation
   * - ``om affirmations categories``
     - ``om affirm cats``
     - View all categories
   * - ``om affirmations category <name>``
     - ``om affirm cat <name>``
     - Get category affirmations
   * - ``om affirmations search <query>``
     - ``om affirm find <query>``
     - Search affirmations
   * - ``om affirmations favorite``
     - ``om affirm fav``
     - Add to favorites
   * - ``om affirmations favorites``
     - ``om affirm favs``
     - View favorites
   * - ``om affirmations stats``
     - ``om affirm stats``
     - View statistics

🎵 Sleep Sounds & Insomnia Support
----------------------------------

Sleep Sounds Commands
~~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Command
     - Alternatives
     - Function
   * - ``om sleep``
     - ``om sounds``, ``om insomnia``
     - View sound categories
   * - ``om sleep categories``
     - ``om sounds cats``
     - View all categories
   * - ``om sleep sounds <category>``
     - ``om sounds <category>``
     - Browse category sounds
   * - ``om sleep search <tag>``
     - ``om insomnia search <tag>``
     - Find sounds by mental health tag
   * - ``om sleep play <sound> [timer]``
     - ``om sounds play <sound>``
     - Start sleep session
   * - ``om sleep stop``
     - ``om sounds stop``
     - End sleep session
   * - ``om sleep mixer``
     - ``om sounds mix``
     - Interactive sound mixer
   * - ``om sleep mixes``
     - ``om sounds saved``
     - View saved mixes
   * - ``om sleep stats [days]``
     - ``om sounds stats``
     - Sleep statistics
   * - ``om sleep preferences``
     - ``om sounds prefs``
     - User preferences

🔧 System & Utility Commands
----------------------------

System Information
~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Command
     - Alternatives
     - Function
   * - ``om help``
     - ``om ?``, ``om --help``
     - Show help information
   * - ``om about``
     - ``om a``, ``om info``
     - About om platform
   * - ``om status``
     - ``om check``
     - System status check
   * - ``om version``
     - ``om --version``
     - Show version information

Data Management
~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Command
     - Alternatives
     - Function
   * - ``om backup``
     - ``om save``
     - Backup wellness data
   * - ``om export``
     - ``om download``
     - Export data for analysis
   * - ``om privacy``
     - ``om data``
     - View privacy settings

Documentation
~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 40 40

   * - Command
     - Alternatives
     - Function
   * - ``om docs``
     - ``om doc``, ``om documentation``
     - Documentation menu
   * - ``om docs serve``
     - ``om doc serve``
     - Start documentation server
   * - ``om docs-build``
     - ``om doc build``
     - Build documentation

🌅 Smart Routines
-----------------

Automated Wellness Workflows
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1
   :widths: 20 60

   * - Command
     - Function
   * - ``om morning``
     - Automated morning wellness routine
   * - ``om evening``
     - Automated evening wellness review
   * - ``om workflow``
     - Comprehensive wellness workflow
   * - ``om checkin``
     - Daily wellness check-in

Natural Language Commands
~~~~~~~~~~~~~~~~~~~~~~~~

om supports natural language for intuitive interaction:

.. code-block:: bash

   om "I'm feeling anxious"        # → om anxiety
   om "help me breathe"            # → om breathe
   om "I need to relax"            # → om calm
   om "track my mood"              # → om mood
   om "I'm grateful for"           # → om gratitude

🎯 Usage Patterns
-----------------

Daily Wellness Routine
~~~~~~~~~~~~~~~~~~~~~~

**Morning (2 minutes)**:

.. code-block:: bash

   om morning                      # Automated morning routine
   # OR manually:
   om qm                          # Quick mood check
   om qg                          # Quick gratitude

**Throughout the Day**:

.. code-block:: bash

   om qb                          # Quick breathing (2min)
   om qf                          # Quick focus reset (1min)
   om qc                          # Quick calm (90s)

**Evening (3 minutes)**:

.. code-block:: bash

   om evening                     # Automated evening routine
   # OR manually:
   om gamify status               # Check progress
   om coach daily                 # Get insights

Crisis Support Pattern
~~~~~~~~~~~~~~~~~~~~~~

**International Crisis Support with Auto-Detection:**

.. code-block:: bash

   # Immediate crisis support (auto-detects your country)
   om crisis                    # Country-specific crisis resources
   om emergency                 # Emergency intervention + grounding
   om rescue crisis            # Same as 'om crisis'
   
   # International support menu
   om rescue international     # Global crisis support options
   om rescue countries         # List all supported countries
   om rescue country US        # Specific country resources
   
   # Setup and customization
   om rescue setup            # Interactive country setup
   om rescue custom           # View custom local resources
   om rescue add-custom       # Add local crisis resource
   
   # Emergency aliases (redirect to appropriate crisis support)
   om 911                     # US emergency
   om 112                     # European emergency  
   om 999                     # UK emergency
   om sos                     # Universal SOS

**Crisis Detection & Nicky Case Integration:**

Om automatically detects crisis language and provides compassionate support:

.. code-block:: bash

   # Crisis keywords trigger immediate intervention:
   # "suicide", "kill myself", "hurt myself", "hopeless", etc.
   
   # Response includes:
   # 🆘 Crisis resources for your country
   # 🐺 Nicky Case "Fear as Friend" wisdom
   # 🧘 Emergency grounding techniques
   # 🤝 Safety planning guidance

**Supported Countries & Resources:**

.. code-block:: bash

   # United States
   om rescue country US
   # 🚨 EMERGENCY: 911
   # 📞 988 Suicide & Crisis Lifeline
   # 💬 Crisis Text Line: Text HOME to 741741
   
   # United Kingdom  
   om rescue country GB
   # 🚨 EMERGENCY: 999
   # 📞 Samaritans: 116 123
   # 💬 SHOUT: Text SHOUT to 85258
   
   # Germany
   om rescue country DE
   # 🚨 EMERGENCY: 112
   # 📞 Telefonseelsorge: 0800 111 0 111
   
   # Australia
   om rescue country AU
   # 🚨 EMERGENCY: 000
   # 📞 Lifeline Australia: 13 11 14
   # 💬 Text: 0477 13 11 14

**Custom Local Resources:**

.. code-block:: bash

   # Add your therapist, local crisis center, etc.
   om rescue add-custom
   # Resource name: Dr. Smith Therapy
   # Phone number: (555) 123-4567
   # Description: My therapist - available weekdays
   
   # View all custom resources
   om rescue custom
   # 🏥 Your Custom Crisis Resources:
   # • Dr. Smith Therapy
   #   📞 (555) 123-4567
   #   📝 My therapist - available weekdays

**Immediate Help**:

.. code-block:: bash

   om resc                        # Crisis resources
   om anx breathe                 # Anxiety breathing
   om qgr                         # Grounding technique

**Follow-up Support**:

.. code-block:: bash

   om coach urgent                # Check AI alerts
   om cope                        # Coping strategies
   om resc plan                   # Safety planning

Deep Analysis Pattern
~~~~~~~~~~~~~~~~~~~~

**Weekly Review**:

.. code-block:: bash

   om dashboard summary           # Wellness overview
   om coach analyze               # Pattern analysis
   om mood stats                  # Mood trends
   om habits stats                # Habit progress

**Monthly Planning**:

.. code-block:: bash

   om autopilot recommendations   # AI suggestions
   om gamify challenge            # New challenges
   om coach summary               # Coaching review

🔤 Complete Alias Reference
---------------------------

All available shortcuts and aliases:

**Quick Actions**: q, qm, qb, qg, qf, qc, qr, qs, qe, qa, qgr, qch, qbox

**Core Functions**: m, b, g, s, h, med, zen

**Support**: anx, dep, resc, cope, sleep

**AI Features**: coach, auto, game, dash, d

**Wellness & Sleep**: affirm, positive, inspire, motivation, sleep, sounds, insomnia, white_noise, nature_sounds, sleep_aid

**System**: help, ?, about, a, status, docs, doc

**Natural Language**: Supports conversational commands for intuitive interaction

This comprehensive reference ensures you can access any om feature quickly and intuitively, whether you prefer short aliases, full commands, or natural language interaction.
