FreeAir Coachโ„ข

Complete User Guide ยท AI-Powered Quit Smoking Companion
๐Ÿ“ฑ Web App ๐Ÿค– AI Coach ๐Ÿง  CBT-Based ๐Ÿ”’ Privacy-First
Developed by Dr. Eskender Beyene, MD, FCCP ยท Board-Certified Pulmonary, Sleep Medicine & Critical Care ยท Founder, FreeAir Coach LLC

๐Ÿ“‹ Table of Contents

  1. Getting Started โ€” Add to Home Screen
  2. โ†ณ Accessing This Manual in the App
  3. Home Dashboard โ€” Your Progress at a Glance
  4. DEADS NOW โ€” Emergency Craving Help
  5. Craving Log โ€” Track Every Urge
  6. Quit Plan โ€” Your 2-Week Roadmap
  7. AI Coach โ€” 24/7 CBT Support
  8. Craving Relief โ€” Guided Sessions
  9. Craving Game โ€” Beat the Urge
  10. Tips for Success
โš•๏ธ Medical Disclaimer: FreeAir Coach is developed by a board-certified pulmonologist for wellness support only โ€” not medical advice. Always consult your physician before starting any pharmacotherapy (Varenicline, Bupropion, or NRT).

1 Getting Started


Open FreeAir Coach in your mobile browser at app.freeaircoach.com. For the best experience, add it to your home screen โ€” it will work and look exactly like a native app.

๐Ÿ“ฑ iPhone (Safari)

  1. Open app.freeaircoach.com in Safari
  2. Tap the Share button (box with arrow pointing up) at the bottom
  3. Scroll down and tap "Add to Home Screen"
  4. Tap "Add" in the top right
  5. The FreeAir Coach icon now appears on your home screen!

๐Ÿค– Android (Chrome)

  1. Open app.freeaircoach.com in Chrome
  2. Tap the three-dot menu (โ‹ฎ) in the top right
  3. Tap "Add to Home screen"
  4. Tap "Add" to confirm
  5. The app icon appears on your home screen!

โœ… First-Time Setup

  • Enter your first name and quit date when prompted
  • Set your smoking triggers (stress, after meals, social, etc.)
  • Choose your readiness stage โ€” the app adapts its coaching to where you are
  • All your data stays on your device only โ€” FreeAir Coach has no health data servers

๐Ÿ“‹ Accessing This Manual in the App

You can open this User Manual at any time directly from within the app โ€” no need to remember a separate URL.

๐Ÿ“ Where to Find It

  1. Open the app at app.freeaircoach.com
  2. Scroll to the very bottom of any screen
  3. Look below the legal links (Medical Disclaimer, Privacy Policy, etc.)
  4. Tap ๐Ÿ“‹ User Manual โ€” it opens in a new tab

๐Ÿ’ก Tip

You can also share this manual directly with others using the link: app.freeaircoach.com/user-manual.html

-->

2 ๐Ÿ  Home Dashboard


Your command center โ€” shows real-time progress and gives quick access to every feature. Everything you need is one tap away.

FreeAir Coach
by a Board-Certified Pulmonologist
2d free ๐Ÿ”ฅ
Hey, Sarah ๐Ÿ‘‹
2 days smoke-free
๐Ÿ†˜
DEADS NOW
๐ŸŽฎ
PLAY GAME
๐Ÿค–
ASK COACH
๐Ÿ“‹
LOG IT
2Days Free ๐Ÿ“…
20Cigs Avoided ๐Ÿšซ
$10Money Saved ๐Ÿ’ฐ
0Cravings Won ๐Ÿ’ช
Home Dashboard

Quick Action Cards

CardWhat it does
๐Ÿ†˜ DEADS NOWInstant craving emergency guide โ€” opens the DEADS strategy immediately
๐ŸŽฎ PLAY GAMEOpens the Memory Match game to distract from cravings
๐Ÿค– ASK COACHOpens your AI coach for immediate support
๐Ÿ“‹ LOG ITQuickly log a craving while it's happening

Progress Stats

StatCalculated from
Days FreeDays since your quit date
Cigs AvoidedDays ร— your average cigarettes/day
Money SavedCigs avoided ร— price per cigarette
Cravings WonLogged cravings you resisted

Lung Recovery Timeline

Scroll down on the Home screen to see your real-time body healing timeline:

LUNG RECOVERYHealing Now
โœ“
20 min
Heart rate & BP drop
โœ“
8 hours
CO levels normalize
โœ“
48 hours
Nerve endings regrowing
โ—‹
2 weeks
Lung function improving
โ—‹
1 month
Coughing decreases

3 ๐Ÿ†˜ DEADS NOW โ€” Emergency Craving Help


Tap DEADS NOW the moment a craving strikes โ€” also accessible from the PLAN tab. Every craving peaks and passes within 3โ€“5 minutes. You do not need to act on it. Work through each letter until the urge subsides.

Quit Plan
Evidence-based tools
๐Ÿ“… 2-Week Plan
๐Ÿ†˜ DEADS
๐Ÿ† Rewards
๐Ÿ†˜ Use This When a Craving Hits
Every craving peaks and passes within 3โ€“5 minutes. Work through each letter.
D
Delay
Wait 5 minutes. The craving will pass.
E
Escape
Remove yourself from the trigger situation.
A
Avoid
Stay away from high-risk environments.
D
Distract
Engage your hands and mind.
S
Substitute
Water, gum, toothpick, or a straw.
Plan โ†’ DEADS Tab

The DEADS Strategy โ€” In Detail

LetterStrategyExample
DDelaySet a 5-minute timer and do nothing"I'll wait until 3:15 before deciding"
EEscapePhysically leave the trigger locationWalk out of the break room, go to a different floor
AAvoidStay away from known trigger environmentsSkip the smoking area, avoid the front entrance
DDistractEngage your hands and mind with something elsePlay the Craving Game, call a friend, do 10 push-ups
SSubstituteReplace the cigarette with an oral substituteWater bottle, sugar-free gum, toothpick, celery straw

๐Ÿ’ก Pro Tip: Substitutes to Keep Handy

  • Sugar-free gum (mint or cinnamon)
  • Toothpicks or coffee stirrers
  • Cold water bottle (the cold sensation helps)
  • Crunchy vegetables (carrots, celery)
  • Nicotine replacement (patch, gum, lozenge) if prescribed

4 ๐Ÿ“‹ Craving Log


Tap LOG in the bottom nav. Track every craving โ€” even the ones you smoke. Each log builds your personal pattern insight so your AI Coach can give you better advice.

Craving Log
Track every craving
+ Log a Craving
๐Ÿ“‹
No logs yet
Every log builds your personal insight.
Craving Log (empty state)
Log a Craving
e.g. After dinner, stress at work...
Select...
Select...
e.g. Home, Office, Car...
๐Ÿ’ช No, Resisted
๐Ÿ˜ž Yes
Save Log
Log a Craving form

Log Fields Explained

FieldWhat to EnterExample
TriggerWhat situation preceded the craving"After dinner", "Stressful meeting", "Driving"
IntensitySlide to rate 1โ€“10 (1=mild, 10=overwhelming)7/10 for a strong after-dinner craving
EmotionYour emotional state when the craving hitStressed, Bored, Anxious, Happy, Tired
SituationSocial contextAlone, With friends, At work, After alcohol
LocationWhere you were (optional)Home, Office, Car, Restaurant, Bar
Did you smoke?Honest answer โ€” no judgmentTap "No, Resisted" or "Yes"

๐Ÿ’ก Why log even when you slip? Honest logs help your AI Coach identify your specific high-risk patterns and give you personalized strategies. Logging a slip is progress, not failure.

Example: A Full Log Entry

FieldEntry
TriggerStressful phone call with my boss
Intensity8/10
EmotionAnxious
SituationAt work, alone
LocationOffice parking lot
Did you smoke?No, Resisted ๐Ÿ’ช

5 ๐Ÿ“… Quit Plan


Tap PLAN in the bottom nav. Your evidence-based 2-week countdown plus clinical tools. The plan adapts based on your readiness stage.

Quit Plan
Evidence-based 2-week countdown
๐Ÿ“… 2-Week Plan
๐Ÿ†˜ DEADS
๐Ÿ† Rewards
๐Ÿ’Š Medications
YOUR READINESS STAGE
Action โ€” Currently quitting
Your coach will give you active CBT strategies, craving management, and daily support.
๐Ÿ“…
Day 14
Set Date & Start Meds
Choose your quit date. Consult doctor about Varenicline or Bupropion.
๐Ÿ“‹
Days 13โ€“10
Track & Delay
Keep a Tobacco Tracker. Delay each cigarette by 5 minutes.
๐Ÿ“ฆ
Days 6โ€“4
Stock Up & Tell People
Build your Emergency Kit. Tell family & friends your quit date.
Quit Plan โ†’ 2-Week Plan

Your Readiness Stage

The plan adapts based on where you are in your quit journey:

StageDescriptionWhat the Coach Does
Pre-contemplationNot thinking about quitting yetBuilds awareness of smoking impacts
ContemplationThinking about quittingWeighs pros/cons, resolves ambivalence
PreparationPlanning to quit soonCreates quit plan, sets date
ActionCurrently quittingActive CBT strategies, daily support
MaintenanceQuit > 6 monthsLong-term relapse prevention

The 4 Plan Tabs

TabContent
๐Ÿ“… 2-Week PlanDay-by-day countdown with specific actions for each phase of quitting
๐Ÿ†˜ DEADSThe DEADS emergency craving strategy (see Section 3)
๐Ÿ† RewardsTrack milestones and celebrate your wins with points
๐Ÿ’Š MedicationsEvidence-based medication information (Varenicline, Bupropion, NRT) โ€” always consult your doctor

The 2-Week Countdown

DaysAction
Day 14Set your quit date. Start Varenicline or Bupropion (needs 1โ€“2 weeks)
Days 13โ€“10Track every cigarette: when, where, why. Delay each by 5 minutes
Days 9โ€“7Relocate tobacco to inconvenient spots. Begin nicotine fading (reduce 50%)
Days 6โ€“4Build Emergency Kit. Tell family and friends your quit date
Days 3โ€“2Plan new behaviors for each trigger. Plan Day 0 rewards
Day 1THE PURGE โ€” Throw away ALL tobacco, lighters, and ashtrays

6 ๐Ÿค– AI Coach


Tap COACH in the bottom nav. Your personal AI quit-smoking coach, available 24/7. Powered by Claude AI, grounded in CBT, Motivational Interviewing, and ACT principles.

AI Coach
Evidence-based CBT coaching ยท Always available
๐Ÿ”’
Messages are processed by Anthropic's API. Your first name and behavioral patterns are included as coaching context. No last name, email, or financial data is transmitted.
I'm having a craving right now ๐Ÿšจ
I slipped and smoked ๐Ÿ˜”
I haven't smoked today! ๐ŸŽ‰
What is the DEADS strategy?
I'm stressed and want to smoke
Should I try medication?
๐Ÿค– FreeAir Coach

Hello! I'm your FreeAir Coach AI โ€” built on CBT, Motivational Interviewing, and ACT principles. I'm here 24/7 to support your quit journey. What's on your mind?

Talk to your coach...
โ–ถ
AI Coach

What the Coach Knows About You

The coach receives your first name, days smoke-free, your known triggers, and your readiness stage. This makes every response personally relevant โ€” not generic advice.

Quick Prompt Suggestions

PromptBest time to use
"I'm having a craving right now ๐Ÿšจ"When an urge hits โ€” get immediate coping strategies
"I slipped and smoked ๐Ÿ˜”"After a slip โ€” get compassionate relapse management
"I haven't smoked today! ๐ŸŽ‰"To celebrate wins and reinforce motivation
"What is the DEADS strategy?"To learn or review the emergency craving tool
"I'm stressed and want to smoke"Stress-triggered cravings โ€” get CBT reframing
"Should I try medication?"To learn about Varenicline, Bupropion, or NRT options

Sample Conversation

I'm having a craving right now after dinner
I hear you โ€” after-dinner cravings are one of the strongest because it's a deeply conditioned habit. Here's what to do right now: Delay โ€” set a 5-minute timer. While you wait, try brushing your teeth or doing 10 deep breaths. The craving will peak and fade within 3โ€“5 minutes. You can do this! ๐Ÿ’ช
What if I can't resist?
If you slip, it's not failure โ€” it's data. Log it in the Craving Log and come back to talk. Many people quit successfully after several attempts. One cigarette doesn't erase your progress. What matters is what you do next. ๐Ÿซ

7 ๐Ÿ˜Œ Craving Relief


Tap RELAX in the bottom nav. Six guided sessions designed to carry you through any craving window. Remember: every craving peaks and passes within 3โ€“5 minutes.

Craving Relief
Guided sessions for any craving
๐Ÿ’ก
Every craving peaks and passes within 3โ€“5 minutes. These sessions are designed to carry you through that window.
๐ŸŒŠ
Urge Surfing
4 min
๐Ÿ’จ
Craving Breathing
3 min
โšก
2-Minute Reset
2 min
๐ŸŒฟ
Stress Release
5 min
๐ŸŒ™
Nighttime Calm
5 min
๐Ÿ†˜
Emergency Craving Break
90 sec
Craving Relief Sessions

The 6 Relief Sessions

SessionDurationBest For
๐ŸŒŠ Urge Surfing4 minRiding a strong craving โ€” observe it without acting
๐Ÿ’จ Craving Breathing3 minImmediate calming โ€” slows heart rate and anxiety
โšก 2-Minute Reset2 minQuick reset when you're busy and a craving hits
๐ŸŒฟ Stress Release5 minStress-triggered cravings โ€” progressive muscle relaxation
๐ŸŒ™ Nighttime Calm5 minEvening cravings and trouble sleeping smoke-free
๐Ÿ†˜ Emergency Craving Break90 secUltra-fast intervention for an overwhelming urge

๐Ÿ’ก When to Use Each Session

  • Craving just hit? Start with Emergency Craving Break (90 sec) or Craving Breathing (3 min)
  • Strong, persistent urge? Try Urge Surfing โ€” learn to observe cravings without reacting
  • Stressed out? Stress Release is the most effective for anxiety-triggered urges
  • Can't sleep? Nighttime Calm helps your body settle into smoke-free nights
  • On a break at work? 2-Minute Reset fits any schedule

8 ๐ŸŽฎ Craving Game


Tap GAME in the bottom nav. Beat the 3โ€“5 minute craving window by playing Memory Match โ€” engaging your hands and mind is one of the most effective craving strategies.

Craving Game
Beat the 3โ€“5 minute craving window
๐Ÿง  Memory Match
0:00
TIME
0
MOVES
0/8
PAIRS
?
?
?
?
?
?
?
?
?
?
?
?
Craving Game โ€” Memory Match

How to Play

  1. Tap any card to flip it and reveal an emoji
  2. Tap a second card to find its match
  3. Matched pairs stay face-up
  4. Unmatched pairs flip back โ€” remember their positions!
  5. Match all 8 pairs to complete the game
  6. Your time and move count are tracked

Why It Works

Memory Match engages your working memory and visual attention โ€” two cognitive functions that directly compete with craving urges. Research on visual-spatial cognitive tasks (Skorka-Brown et al., Addictive Behaviors, 2015) shows that brief concentration-demanding activities can meaningfully reduce craving intensity. The 3โ€“5 minute game window aligns perfectly with the natural craving arc.

๐ŸŽฏ Game Strategy Tips

  • Start from a corner and work systematically โ€” builds concentration
  • Whisper the emoji as you flip each card โ€” adds another layer of distraction
  • Challenge yourself to beat your move count each time
  • After completing the game, check in: is the craving still there? Usually it's gone or significantly reduced

9 ๐Ÿ’ก Tips for Success


๐Ÿ—“ Days 1โ€“3: The Critical Window

Highest craving period โ€” protect yourself:

  • Keep your phone accessible with the app open
  • Avoid your top 3 triggers for the first 72 hours if possible
  • Tell at least one supportive person today is Day 1
  • Drink lots of water โ€” it helps flush nicotine metabolites
  • Have your Emergency Kit physically ready (gum, toothpicks, water)
  • Use the Emergency Craving Break (90 sec) every time

๐Ÿ—“ Days 4โ€“14: Building Momentum

Cravings start decreasing in frequency:

  • Log every craving โ€” even the ones you resist. Patterns emerge
  • Talk to your AI Coach at least once a day
  • Collect your Rewards milestones โ€” the points are motivational data
  • Find new routines to replace trigger moments (tea instead of coffee break smoke)
  • Celebrate 7-day and 14-day milestones with a real reward

๐Ÿ—“ Day 15+: Long-Term Success

Physical addiction is largely resolved โ€” now it's behavioral:

  • Stay alert for "just one cigarette" thinking โ€” it's a trap
  • Continue logging whenever a craving appears (they become rare)
  • Check back with your AI Coach during stressful life events
  • Share your success with others โ€” it reinforces your own commitment

If You Slip

One cigarette โ‰  relapse. It's data.

  • Log it honestly in the Craving Log
  • Tell your AI Coach what happened โ€” no judgment
  • Identify what triggered it and what you'll do differently
  • Most successful quitters take 3โ€“5 attempts โ€” each attempt teaches you something
  • Reset your quit date and start again immediately โ€” don't wait for "Monday"

Privacy Reminder

๐Ÿ”’ Your health data is stored only on your device. FreeAir Coach does not maintain a database of your health information on our servers. AI Coach messages are processed by Anthropic's API under their privacy terms and are not retained on our servers. The app is subject to the FTC Health Breach Notification Rule (16 CFR Part 318). This app is separate from Washington Metro Sleep Institute clinical services.