← FoodPile

FAQ

How Foodpile works, and the thinking behind a few of its choices.

How Foodpile works The caffeine curve Neutral days Weight & the goal-date forecasts Goals, macros & fibre Units & precision The trends page

How Foodpile works

What is Foodpile?

Foodpile is an MCP-first tracker. Instead of tapping through a food database, you tell your AI assistant (Claude, ChatGPT, Mistral) what you ate, did, or weigh, and it logs it over Foodpile’s MCP server. The website is a datastore plus a dashboard that shows your day, trends and forecasts.

Does Foodpile run AI on its servers?

No. Foodpile is a datastore, not an AI service — there are no server-side AI calls and no models running on Foodpile. The intelligence lives in the assistant you already use; your data is never sold.

Can I edit things without the assistant?

Yes. The dashboard cards have an in-app add (the header +) and per-row edit/delete for caffeine, water, weight and measurements, so quick corrections don’t need a chat. The assistant is still best for anything in natural language.

The caffeine curve

How is the caffeine curve calculated?

It models caffeine in your body as first-order exponential decay: each dose adds its milligrams at the time you had it, and the total falls by half every half-life (5 hours by default, adjustable). The curve is the sum of all the day’s doses decaying over time — solid up to now, dashed for the projection.

What is the dashed line at ~50 mg?

It’s the sleep threshold — the level below which caffeine is unlikely to disturb sleep. The card tells you the clock time your level is projected to drop below it, so you can judge a late coffee against bedtime.

What are the +40 / +80 / +160 mg buttons?

A "what if I had a coffee now?" preview: they drop a hypothetical dose at the current time so you can see how the rest of the day (and bedtime) would look. It is a preview only — nothing is logged and nothing is sent to the server. You can hide the experiment in settings.

What is the "Caffeine vs bedtime" chart on the trends page?

The caffeine card answers "when does today clear?"; this answers "how often am I too late?". Each point is one NIGHT, plotted at the clock time your caffeine fell below the 50 mg sleep line, measured from that day's last dose. A night runs 09:00 to 09:00, so clearing at 01:20 belongs to the evening before rather than to the morning it lands in — which is why the axis starts at 09:00 and nothing sits below it. A point above the dashed bedtime line is drawn red — that night you were still over the threshold when you meant to sleep. Set your bedtime under Settings → Caffeine (or just tell your assistant); it defaults to 23:00.

Why does a day I drank nothing have no point?

Because there is no question to answer: a day without a dose never had caffeine to clear, and plotting it at midnight would look like a great night rather than a blank one. Only days with a dose of their own get a point, so gaps in the line are gaps in the coffee. A day whose caffeine never crossed 50 mg at all is plotted at its last dose — it was already below the line when the cup landed.

The summary says "typically clear by" — why not an average?

Because one 02:00 espresso night is worth several hours, and a mean would drift above your bedtime line while most nights sat comfortably under it — it would read as "you are always late" when you rarely are. The median describes a typical night instead, which is the question the chart is asking. Neutral-marked days are left out of it, as they are from every other average.

Neutral days

What does marking a day "neutral" do?

It says "this day was maintenance" — you neither gained nor lost ground on it. In the calorie-balance forecast the day is counted as a day at exactly your maintenance TDEE: whatever was (or wasn’t) logged is discarded, and the day contributes no deficit of its own. Use it for a day whose food logging was incomplete or off — a half-logged day (breakfast only) would otherwise look like a huge deficit and make the forecast over-optimistic.

Does a neutral day slow down my forecast?

Yes, slightly — and that is deliberate. Counting the day at maintenance dilutes your average pace by the share of days that were neutral: 15 logged days at a 500 kcal/day deficit plus 5 neutral days averages out to 375 kcal/day. Simply deleting those days would instead model a future in which off-days never happen again, which quietly makes every goal date too optimistic for anyone with a recurring rest or holiday day. The card names the neutral days in its basis line so the number always adds up.

Does it affect the weigh-in forecast too?

No. The scale-trend forecast reads your weigh-ins, and a weigh-in is empirical — the scale said what it said. Marking a day neutral is a statement about food-logging quality, so it changes only the calorie-balance forecast and the trend averages. That separation is also why the two estimates are worth having side by side.

What if I logged nothing at all that day?

Mark it anyway. An unlogged day is normally invisible to the forecast — it is simply absent, so a week away would leave your pace looking untouched. Marking it makes the day count as maintenance, which is usually much closer to the truth for a holiday or a day off tracking. On the charts such a day shows a flat mark on the baseline, since there is no bar to fade.

How do I mark one?

Three ways: the toggle in the today card on the dashboard, tapping a day’s bar on the trends page, or asking your assistant ("mark yesterday as incomplete"). A marked day shows faded on the trend bars, with a flat mark on the baseline.

Isn’t a fasting day the same thing?

No — a fast is a real, intended deficit, so fasting days stay as real data and are never auto-marked. Neutral marking is a manual signal that a day’s data is unreliable, not that you ate little on purpose.

Weight & the goal-date forecasts

Why are there two goal-date estimates?

They are two independent views of the same goal. One reads the scale trend (a least-squares line through your weigh-ins). The other reads the calorie balance (your mean intake over recent logged days vs. your maintenance TDEE). When they agree you can trust the date; when they disagree that itself is informative — e.g. the scale hasn’t caught up with a new deficit yet.

The forecast jumped — why?

The calorie-balance estimate averages your logged days, so one under-logged day pulls it. Mark such days neutral (see above) and it settles — they then count as maintenance days instead of as enormous deficits. The forecast is descriptive, not a promise — it just extends your current pace.

What about body measurements?

Waist/hips/chest/arm/thigh are the fat-sensitive companion to the scale: during recomposition the scale can sit still for weeks while a falling waist shows the real progress. Each site is its own line on the measurements chart.

Goals, macros & fibre

Static vs. dynamic calorie goal?

A static goal is a fixed daily number. A dynamic goal is a base plus the calories you burn from logged activity — so a workout raises the day’s target ("eat back" your training). Pick whichever matches how you like to plan.

How is fibre handled?

Fibre is tracked as its own macro dimension and totalled like protein/carbs/fat. Because it is a subset of carbohydrate, it isn’t part of the calorie-balance split — it just gets its own bar (and a broad 30 g/day fallback when you haven’t set a target).

Where does the fibre goal line come from?

From your own fibre goal under Settings → Goals if you have set one. If you haven’t, the chart falls back to 30 g — the same reference the dashboard’s macro row uses. Protein, carbs and fat are personal targets that depend on your body and intent, but fibre has a broad daily recommendation, so a sensible default is more useful than a chart of grams with nothing to compare them to. Days that fall short are dimmed rather than recoloured: missing fibre is a gap, not an error.

Units & precision

Can I use lb, inches or kJ?

Yes — set your unit system and energy unit in your profile. Values are stored canonically (kg, cm, kcal) and shown in your unit everywhere, including what the assistant reports back.

Do conversions lose precision?

No — conversions keep a decimal, so an inch value converted to cm and back lands on the same number. The same care applies to weight (kg/lb) and energy (kcal/kJ).