FreeAir Coachโ„ข

Complete User Guide ยท AI-Powered Quit Smoking & Vaping 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. Getting Around โ€” The Redesigned App
  4. Home Dashboard โ€” Your Progress at a Glance
  5. SOS โ€” Emergency Craving Help
  6. Craving Log โ€” Track Every Urge
  7. AI Coach โ€” 24/7 CBT Support
  8. Me โ€” Profile, Milestones & Account
  9. Staying Free โ€” Maintenance & Relapse Prevention
  10. Tools & Sessions โ€” Plan, Relax, Game, Lessons
  11. 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).

โ˜… ๐Ÿงญ Getting Around โ€” The Redesigned App


FreeAir Coach has a clean, thumb-friendly bottom bar with five buttons. Here's the whole app at a glance:

๐Ÿซ
Home
๐Ÿ“‹
Log
SOS
SOS
๐Ÿค–
Coach
๐Ÿ™‚
Me
ButtonWhat it does
๐Ÿซ HomeYour dashboard โ€” live Clean Air streak, money saved, and your real-time lung-recovery timeline.
๐Ÿ“‹ LogRecord each craving in a few taps (strength, trigger, and whether you resisted).
๐Ÿ†˜ SOSThe raised red center button โ€” instant craving rescue from any screen (Breathing Balloon + Craving Pop game).
๐Ÿค– CoachYour 24/7 AI coach, built on evidence-based CBT.
๐Ÿ™‚ MeYour profile, milestones, Tools & Sessions, and account settings.

Where did Plan, Relax, Game & Lessons go?

They're all one tap away under Me โ†’ Tools & Sessions โ€” along with Staying Free (your maintenance & relapse-prevention screen). Your subscription, provider access, and account deletion live under Me โ†’ Account & More.

1 Getting Started


๐Ÿ“ฒ Download FreeAir Coach

Get the free app on your phone โ€” available on both stores:

Download on theApp Store GET IT ONGoogle Play

Prefer the web? You can also use FreeAir Coach right in your mobile browser at app.freeaircoach.com โ€” and add it to your home screen so it works and looks 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 (takes about 20 seconds)

  • A quick, one-tap-per-screen wizard asks just four things: What are you quitting? (Cigarettes / Vaping / Both), your last cigarette or vape (Today / Yesterday / a date), how many a day, and the cost per pack or pod โ€” no long forms.
  • Confirm the brief privacy consent, then you land straight on your live Clean Air clock.
  • On the welcome screen, tap "Yes, guide me" for a short interactive walkthrough of each button, or "Skip to Check-in" to dive right in.
  • All your data stays on your device only โ€” FreeAir Coach has no health data servers.

๐Ÿ’จ Choose Your Quit: Cigarettes, Vaping, or Both

The first onboarding question shapes the entire app for you. Pick what you're actually quitting and every screen adapts.

  • Cigarettes โ€” you smoke combustible tobacco. Recovery timeline includes carbon monoxide clearance, cilia recovery, and long-term lung-cancer risk drop. Trigger chips: stress, coffee, food, alcohol, social, driving, boredom.
  • Vaping โ€” you use e-cigarettes, pods, or disposables. Timeline focuses on nicotine clearance, taste and smell, sleep, and cardiovascular recovery. Combustion-specific milestones are hidden because they don't apply. Trigger chips add phone / scrolling, studying, gym, and party โ€” the strongest anchors for vape use.
  • Both โ€” you use both products. The full smoking timeline applies, plus the vape-specific triggers, and the AI Coach is grounded in both the smoking manual and the vaping guide. The plan is to quit both on the same Quit Day.

The AI Coach adapts too: for vape and dual users it loads a full clinical vaping grounding sourced to CDC, Truth Initiative, USPSTF, and the 2020 Surgeon General Report โ€” and honors the honest fact that no medication is FDA-approved specifically for vaping cessation.

๐Ÿ“‹ 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.

home screen
Actual redesigned screen
Home Dashboard

Quick Action Cards

CardWhat it does
๐Ÿ†˜ SOSInstant craving rescue โ€” opens the Breathing Balloon and Craving Pop game
๐ŸŽฎ 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 (labeled smoke-free / vape-free / nicotine-free based on your choice)
AvoidedDays ร— your daily count. Labeled cigarettes for smokers, puffs for vapers, nicotine hits for dual users.
Money SavedAvoided ร— cost per unit (default: $0.50/cig, $0.20/puff, $0.35/hit)
Cravings WonLogged cravings you resisted

๐Ÿ’จ Vape users: Your Recovery Timeline hides three combustion-only milestones (carbon monoxide clears, cilia recovery, lung-cancer risk halved) because those aren't part of vaping physiology. What stays: heart rate, nicotine clearance, taste and smell, sleep, cardiovascular, and stroke risk. Dual users see the full smoking timeline because they're quitting cigarettes too.

Lung Recovery Timeline

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

3 ๐Ÿ†˜ SOS โ€” Emergency Craving Help


Tap the red SOS button in the center of the bottom bar the moment a craving strikes โ€” it's reachable from every screen. It opens two fast tools: the Breathing Balloon (a guided box-breathing exercise โ€” in 4, hold 4, out 4, hold 4 for 3 minutes) and Craving Pop (a 30-second distraction game). Every craving peaks and passes within 3โ€“5 minutes โ€” these tools carry you through that window. The DEADS steps below are a simple coping framework you can also run through in your head, or ask your Coach to walk you through in chat.

deads screen
Actual redesigned screen
Tap SOS (center)

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.

log screen
Actual redesigned screen
Craving Log (empty state)
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.

๐Ÿ’จ Vape and dual users: Your Trigger chip list includes four extra tags that don't appear for cigarette-only users โ€” Phone / scrolling, Studying, Gym, and Party. These are the strongest behavioral anchors for e-cigarette use. Tag them accurately and the Coach will surface trigger-specific coping strategies.

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


Open the Me tab, then tap 2-Week Plan under Tools & Sessions. 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.

coach screen
Actual redesigned screen
AI Coach

What the Coach Knows About You

The coach receives your first name, what you're quitting (Cigarettes / Vaping / Both), days smoke-free or vape-free, your known triggers, and your readiness stage. This makes every response personally relevant โ€” not generic advice.

๐Ÿ’จ Vape and dual users: The Coach also loads a full clinical vaping cessation guide sourced to CDC, Truth Initiative ("This Is Quitting" โ€” text DITCHVAPE to 88709), USPSTF (2021), and the 2020 Surgeon General Report. Ask it about the Penn State Electronic Cigarette Dependence Index, the REFUSE method for social pressure, or how to break the phone-and-vape hand-to-mouth pair โ€” it'll answer from the guide. It will also tell you honestly that no medication is FDA-approved specifically for vaping cessation (NRT and varenicline are extrapolated from cigarette-cessation trials, offered off-label). Smoking users don't get the vaping guide loaded โ€” bandwidth is only spent when it's relevant to you.

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


Open the Me tab, then tap Relax under Tools & Sessions. 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


Open the Me tab, then tap Game under Tools & Sessions (it's also a Home quick action). 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

โ˜… ๐Ÿ™‚ Me โ€” Profile, Milestones & Account


me screen
Actual redesigned screen

Tap Me (far-right of the bottom bar) for everything about you:

โ˜… ๐ŸŒฟ Staying Free โ€” Maintenance & Relapse Prevention


maintain screen
Actual redesigned screen

Quitting isn't the finish line โ€” staying quit is. Open Me โ†’ Tools & Sessions โ†’ Staying Free for the maintenance screen:

Note: "DEADS" (Delay, Escape, Avoid, Distract, Substitute) is a coping framework your Coach can walk you through in chat โ€” for hands-on, in-the-moment relief, tap the red SOS button.

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.