Shortcuts Reference
===================

Complete reference for all om command shortcuts and aliases. Every function has multiple shortcuts for maximum convenience.

🎯 Philosophy
=============

om provides multiple ways to access every feature:

- **Technical shortcuts** (``qm``, ``d``, ``st``) for power users
- **Natural language** (``stressed``, ``anxious``, ``grateful``) for intuitive use
- **Full commands** (``mood``, ``dashboard``, ``status``) for clarity
- **Emergency shortcuts** (``crisis``, ``rescue``, ``help``) for urgent needs

Use whatever feels most natural to you!

⚡ Ultra-Quick Actions (q-series)
=================================

The fastest way to practice wellness:

.. list-table:: Quick Actions
   :header-rows: 1
   :widths: 15 25 40 20

   * - 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
   * - ``om qs``
     - ``om quick stretch``
     - Physical tension release
     - 1min
   * - ``om qe``
     - ``om quick energy``
     - Energy boost techniques
     - 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

**Usage Examples:**

.. code-block:: bash

   # Ultra-fast mood check
   om qm 7

   # Quick breathing with custom technique
   om qb --technique box

   # Gratitude with category
   om qg "My health" --category health

🧠 Core Mental Health Functions
===============================

Primary mental health tools with multiple access methods:

Mood & Tracking
---------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om m``
     - ``mood``, ``mt``, ``track``
     - Comprehensive mood tracking
   * - ``om moods``
     - ``mood list``, ``mood history``
     - View mood history
   * - ``om mood_analytics``
     - ``mood stats``, ``mood analyze``
     - Mood pattern analysis

**Examples:**

.. code-block:: bash

   om m                     # Full mood tracking interface
   om mood 8 --energy 7     # Quick mood with energy
   om moods --days 30       # Last 30 days of moods

Breathing & Meditation
----------------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om b``
     - ``breathe``, ``br``, ``breath``
     - Breathing exercises menu
   * - ``om med``
     - ``meditation``, ``zen``
     - Enhanced meditation sessions
   * - ``om mindful``
     - ``mindfulness``, ``present``
     - Mindfulness practices

**Examples:**

.. code-block:: bash

   om b                     # Breathing exercises menu
   om breathe 4-7-8         # Specific breathing technique
   om med 10                # 10-minute meditation

Gratitude & Positivity
-----------------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om g``
     - ``grat``, ``thanks``, ``appreciate``
     - Gratitude practice
   * - ``om grateful``
     - ``thankful``, ``blessed``
     - Natural language gratitude

**Examples:**

.. code-block:: bash

   om g                     # Gratitude practice interface
   om grateful              # Natural language entry
   om thanks "My family"    # Direct gratitude entry

🆘 Mental Health Support
========================

Comprehensive support with crisis-aware shortcuts:

Anxiety & Panic
---------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om anx``
     - ``anxiety``, ``panic``, ``worry``
     - Anxiety support tools
   * - ``om anxious``
     - ``worried``, ``nervous``
     - Natural language anxiety support
   * - ``om panic``
     - ``panicking``, ``overwhelmed``
     - Immediate panic support

**Examples:**

.. code-block:: bash

   om anx                   # Anxiety management menu
   om anxious               # → Automatic grounding technique
   om panic                 # → Immediate panic protocol

Depression & Mood
-----------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om dep``
     - ``depression``, ``sad``, ``down``
     - Depression support resources
   * - ``om low``
     - ``blue``, ``empty``
     - Low mood support
   * - ``om hopeless``
     - ``despair``, ``dark``
     - Crisis-level depression support

**Examples:**

.. code-block:: bash

   om dep                   # Depression support menu
   om sad                   # → Mood lifting techniques
   om hopeless              # → Crisis resources + support

Coping & Skills
---------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om cope``
     - ``coping``, ``strategies``
     - Coping strategies menu
   * - ``om cs``
     - ``skills``, ``techniques``
     - Coping skills library
   * - ``om dbt``
     - ``dialectical``, ``regulation``
     - DBT techniques

**Examples:**

.. code-block:: bash

   om cope                  # Coping strategies menu
   om skills immediate      # Immediate coping skills
   om dbt distress         # DBT distress tolerance

🚨 Crisis & Emergency Support
=============================

Immediate access to crisis resources:

Emergency Access
----------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om resc``
     - ``rescue``, ``crisis``, ``emergency``
     - Crisis support resources
   * - ``om help``
     - ``sos``, ``911``
     - Emergency mental health help
   * - ``om urgent``
     - ``now``, ``immediate``
     - Urgent support protocols

**Examples:**

.. code-block:: bash

   om rescue                # → Crisis resources + hotlines
   om crisis                # → Emergency support menu
   om urgent                # → Immediate intervention

**Always Available Emergency Numbers:**
- National Suicide Prevention Lifeline: **988**
- Crisis Text Line: Text **HOME** to **741741**

😴 Sleep & Physical Wellness
============================

Sleep Support
-------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om sleep``
     - ``insomnia``, ``tired``, ``rest``, ``bedtime``
     - Sleep support tools
   * - ``om sleepy``
     - ``drowsy``, ``exhausted``
     - Natural language sleep support

**Examples:**

.. code-block:: bash

   om sleep                 # Sleep support menu
   om tired                 # → Energy vs. rest assessment
   om bedtime               # → Bedtime routine

Physical Wellness
-----------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om s``
     - ``stretch``, ``physical``, ``exercise``, ``move``, ``workout``
     - Physical wellness exercises
   * - ``om tense``
     - ``tight``, ``sore``
     - Tension release techniques

**Examples:**

.. code-block:: bash

   om s                     # Physical wellness menu
   om stretch back          # Back-specific stretches
   om tense                 # → Progressive muscle relaxation

🤝 Social & Personal Growth
===========================

Social Connection
-----------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om soc``
     - ``social``, ``connect``, ``friends``, ``relationship``
     - Social connection tools
   * - ``om lonely``
     - ``isolated``, ``alone``
     - Loneliness support

**Examples:**

.. code-block:: bash

   om soc                   # Social connection menu
   om lonely                # → Connection strategies
   om friends               # → Friendship support

Journaling & Reflection
-----------------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om j``
     - ``journal``, ``write``, ``reflect``, ``diary``
     - Guided journaling
   * - ``om thoughts``
     - ``thinking``, ``mind``
     - Thought exploration

**Examples:**

.. code-block:: bash

   om j                     # Guided journaling interface
   om journal mood          # Mood-focused journaling
   om thoughts              # → Thought record (CBT)

🤖 AI & Automation Features
===========================

AI Coaching
-----------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om coach``
     - ``ai``, ``coaching``, ``mentor``, ``guide``
     - AI mental health coach
   * - ``om daily``
     - ``today``, ``insight``
     - Daily coaching insight

**Examples:**

.. code-block:: bash

   om coach                 # AI coaching menu
   om daily                 # → Today's personalized insight
   om ai analyze            # → Pattern analysis

Autopilot & Tasks
-----------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om auto``
     - ``pilot``, ``autopilot``
     - Wellness automation
   * - ``om tasks``
     - ``routine``, ``todo``
     - Automated wellness tasks

**Examples:**

.. code-block:: bash

   om auto                  # Autopilot system menu
   om tasks                 # → View pending wellness tasks
   om pilot morning         # → Morning routine

Gamification
------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om game``
     - ``gamify``
     - Gamification system
   * - ``om achieve``
     - ``achievements``
     - View achievements
   * - ``om points``
     - ``level``, ``stats``, ``progress``
     - Progress status

**Examples:**

.. code-block:: bash

   om game                  # Gamification menu
   om achieve -v            # → Beautiful achievements gallery
   om level                 # → Current level and XP

📊 Analytics & Data
===================

Dashboard & Analytics
---------------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om d``
     - ``dash``, ``dashboard``, ``analytics``, ``data``
     - Wellness dashboard
   * - ``om live``
     - ``realtime``
     - Live updating dashboard
   * - ``om summary``
     - ``overview``
     - Quick dashboard summary

**Examples:**

.. code-block:: bash

   om d                     # Static dashboard
   om dash live 60          # → Live dashboard, 60s refresh
   om summary               # → Quick overview

Pattern Analysis
----------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om patterns``
     - ``analysis``, ``analyze``, ``trends``
     - Pattern analysis
   * - ``om triggers``
     - ``causes``, ``factors``
     - Trigger analysis

**Examples:**

.. code-block:: bash

   om patterns              # → Pattern analysis menu
   om analyze mood          # → Mood pattern analysis
   om triggers              # → Trigger identification

🗣️ Natural Language Commands
============================

Emotional States
----------------

Just describe how you feel:

.. list-table:: Emotional State Shortcuts
   :header-rows: 1
   :widths: 25 25 50

   * - Feeling
     - Command
     - Result
   * - ``om stressed``
     - → ``om qb``
     - 2-minute breathing exercise
   * - ``om anxious``
     - → ``om qgr``
     - 5-4-3-2-1 grounding technique
   * - ``om overwhelmed``
     - → ``om qr``
     - Complete mental reset
   * - ``om unfocused``
     - → ``om qf``
     - Attention reset technique
   * - ``om grateful``
     - → ``om qg``
     - Gratitude practice
   * - ``om tense``
     - → ``om qs``
     - Physical tension release
   * - ``om low``
     - → ``om qa``
     - Positive affirmations
   * - ``om scattered``
     - → ``om qc``
     - Progressive relaxation
   * - ``om restless``
     - → ``om qe``
     - Energy channeling techniques

**Advanced Emotional States:**

.. code-block:: bash

   om angry                 # → Anger management techniques
   om frustrated            # → Frustration coping strategies
   om disappointed          # → Disappointment processing
   om excited               # → Energy channeling
   om nervous               # → Nervousness support
   om confused              # → Clarity techniques

Time-Based Commands
-------------------

.. list-table:: Time-Based Shortcuts
   :header-rows: 1
   :widths: 25 25 50

   * - Time
     - Command
     - Result
   * - ``om morning``
     - → ``om autopilot morning``
     - Morning wellness routine
   * - ``om evening``
     - → ``om autopilot evening``
     - Evening reflection routine
   * - ``om daily``
     - → ``om coach daily``
     - Daily AI coaching insight
   * - ``om checkin``
     - → ``om qch``
     - Comprehensive wellness check

🔧 System & Meta Commands
=========================

System Information
------------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om a``
     - ``about``, ``info``
     - About om information
   * - ``om v``
     - ``version``
     - Version information
   * - ``om st``
     - ``status``
     - System status check
   * - ``om ?``
     - ``help``
     - Help system

**Examples:**

.. code-block:: bash

   om st                    # → System status check
   om about                 # → About om and resources
   om ?                     # → Help system

Configuration & Data
--------------------

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

   * - Shortcut
     - Alternatives
     - Function
   * - ``om config``
     - ``settings``, ``prefs``
     - Configuration management
   * - ``om backup``
     - ``save``
     - Create data backup
   * - ``om export``
     - ``download``
     - Export wellness data

**Examples:**

.. code-block:: bash

   om config show           # → View current settings
   om backup                # → Create backup
   om export mood           # → Export mood data

💡 Usage Strategies
===================

Progressive Learning
--------------------

**Week 1: Master the Basics**

.. code-block:: bash

   om qm                    # Daily mood check
   om qb                    # When stressed
   om qg                    # Evening gratitude

**Week 2: Add Natural Language**

.. code-block:: bash

   om stressed              # Instead of remembering qb
   om grateful              # Instead of remembering qg
   om tired                 # Explore energy techniques

**Week 3: Explore AI Features**

.. code-block:: bash

   om daily                 # Daily AI insights
   om coach analyze         # Pattern analysis
   om auto tasks            # Automated recommendations

**Week 4: Advanced Integration**

.. code-block:: bash

   om morning && om daily   # Chained morning routine
   om game -v               # Visual progress celebration
   om patterns mood         # Deep pattern analysis

Context-Aware Usage
-------------------

**At Work:**

.. code-block:: bash

   om qf                    # Focus reset
   om qs                    # Desk stretches
   om stressed              # Quick stress relief

**At Home:**

.. code-block:: bash

   om qc                    # Relaxation
   om grateful              # Gratitude practice
   om evening               # Evening routine

**In Crisis:**

.. code-block:: bash

   om rescue                # Crisis resources
   om panic                 # Immediate support
   om qgr                   # Grounding technique

Command Chaining
----------------

Combine commands for powerful workflows:

.. code-block:: bash

   # Morning routine
   om qm && om daily && om qg

   # Stress response protocol
   om stressed && om qa && om coach urgent

   # Evening wind-down
   om qm && om evening && om game -v

   # Crisis protocol
   om rescue && om qgr && om coach urgent

🎯 Personalization Tips
=======================

Find Your Style
----------------

**Technical Users:**
- Use short shortcuts: ``qm``, ``d``, ``st``
- Chain commands: ``om qm && om d``
- Explore advanced features: ``patterns``, ``analyze``

**Natural Language Users:**
- Describe feelings: ``stressed``, ``grateful``, ``tired``
- Use full words: ``breathe``, ``mood``, ``help``
- Follow suggestions: Let om guide your journey

**Visual Users:**
- Use visual mode: ``-v`` flag for supported commands
- Celebrate progress: ``om game -v``
- Explore beautiful interfaces

**Crisis-Aware Users:**
- Remember emergency shortcuts: ``rescue``, ``crisis``, ``help``
- Practice grounding: ``qgr``, ``panic``
- Know the numbers: 988, text HOME to 741741

Muscle Memory Development
-------------------------

**Daily Essentials (Practice These):**

.. code-block:: bash

   om qm                    # Most important command
   om qb                    # Most useful technique
   om rescue                # Most critical resource

**Weekly Exploration:**

.. code-block:: bash

   om daily                 # AI insights
   om game -v               # Progress celebration
   om patterns              # Self-understanding

**Monthly Deep Dives:**

.. code-block:: bash

   om coach analyze         # Comprehensive analysis
   om export                # Data backup
   om config                # Settings review

🔍 Discovery Features
=====================

When You Don't Know What You Need
----------------------------------

.. code-block:: bash

   om                       # Interactive menu
   om ?                     # Help system
   om about                 # Learn about features

**Exploration Commands:**

.. code-block:: bash

   om help mood             # Learn about mood tracking
   om help breathing        # Learn about breathing
   om help crisis           # Learn about crisis support

**Smart Suggestions:**

om learns your patterns and suggests relevant commands based on:
- Time of day
- Recent mood entries
- Usage history
- Effectiveness ratings

Next Steps
==========

After mastering shortcuts:

1. **Explore Advanced Features:**
   - :doc:`ai_coaching` - Personalized insights
   - :doc:`wellness_autopilot` - Automated support
   - :doc:`visual_dashboard` - Beautiful interfaces

2. **Deepen Understanding:**
   - :doc:`cli_reference` - Complete command reference
   - :doc:`database_system` - Data management
   - :doc:`troubleshooting` - Problem solving

3. **Build Your Practice:**
   - Start with 3 commands: ``qm``, ``qb``, ``qg``
   - Add natural language: ``stressed``, ``grateful``
   - Explore AI features: ``daily``, ``coach``

**Remember**: There's no wrong way to use om. Pick the shortcuts that feel natural and build your own mental wellness routine.

🎯 **Master the shortcuts to unlock effortless mental health support.**
