Ember

Log each cigarette, vape or joint in one tap, and ride out the cravings.

Ember counts what you use and the cravings that passed. Your day shows on a clock. When a craving comes, Ember offers a virtual one, a breathing exercise or a few push-ups instead.

The cartridge id is @mnemosyne-plugins/mnemo-ember. Its code lives at Mnemosyne-OS/MnemoEmber.

First launch

What do you use? Pick Cigarette, Vape or Joint, one or more, then Start. Change it later under What you use.

Main gestures

• I'm having one logs a use. With several substances tracked, Ember asks Which one? A toast offers Undo.
• Before a use, Ember may ask Ride it out first? Show me opens the ways to hold on. No, log it logs the use.
• Craving? opens Ride it out. Pick a way:
  • Virtual one: hold the button, or the space bar, to draw in, then breathe out. I'm good now logs the craving as passed.
  • Box breathing: in 4, hold 4, out 4, hold 4.
  • Push-ups or Squats: pick a number, tap once per rep.
  • Stretching: five stretches, 30 seconds each.
  • A short walk: five minutes, then come back.
  • A glass of water, drunk slowly.

What you see

• Today: the time since your last one, today's count, the count by this time yesterday, the cravings passed and the Longest stretch this week.
• Last 7 days, compared with the 7 days before.
• Since a date (the totals): days tracked, uses per day, cravings passed. For cigarettes only, an estimate of life lost and life kept, at about 20 minutes per cigarette (UCL study, 2024). No published figure exists for vapes or joints.
• Your patterns, from the last 28 days: the two-hour peak, weekdays against weekends, and how long each way of riding a craving held before the next use. Ember says these links show when things happen, not why.

Camera watch

Watch with the camera lets Ember notice when you smoke at your desk. It looks for a rhythm: a hand at your mouth several times in a few minutes. Then it asks Smoking?

• Yes logs a use.
• No writes nothing and asks less often.
• Take a virtual one instead opens the virtual one.

It needs the gesture camera on, in Settings › Gestures. Ember receives only the time and length of each moment your hand stays at your mouth. The camera image stays inside Mnemosyne OS. Ask after sets how many times before it asks.

Where your data goes

• The log is kept by Mnemosyne OS on your computer, up to 256 KB. A change that does not fit is refused and said.
• Keep it in memory is off until you press it. Ember then writes one summary per finished day and one current status into its own vault. The chat reads that vault once you unlock it from the Vault panel.
• Forget what was written removes those entries from the vault.

For agents

Action	Effect
today, events, totals, patterns	read
logUse, logPassed	write
rideItOut, startVirtual, showSettings, closeView	write (screen)
answerCamera, setCameraWatch, setTracked	write

With several substances tracked and none said, logUse is refused with AMBIGUOUS and the list. Voice examples: "show my numbers for today", "show my habits", "show the ways to ride it out", "open Ember and log a cigarette".