Box — The Complete Guide
A health app people actually use — because it lives in WhatsApp
A personal coaching agent built on Claude Code + CrewAI, with long-term memory in Qdrant, image OCR through Google Cloud Vision API, and an auto-generated ICS calendar feed. Interface: WhatsApp via the Delegator. State is stored as a single JSON file plus an encrypted SQLite database. In my own setup it accompanies a personal weight-loss and strength program, but this is a coach-agent pattern — not a diet plan. You can adapt it to sleep, running, habit change, learning an instrument, money management, or any measurable personal goal the user sets for themselves.
What this guide covers
What is Box?
An autonomous personal coach — intake through WhatsApp
Box is a personal coach that lives in your pocket — an AI agent that receives WhatsApp messages (text or image), understands what you said in plain language, remembers it long-term, and replies with the next step. It isn't a new app you have to download and learn; it's a WhatsApp conversation, exactly like chatting with a friend who also tracks, calculates, and never judges.
Intake — how you talk to it
Free text in your own words, Box understands and stores it
Intake is the ingestion step for every new data point. Instead of a form with fields, Box works with free text: you write naturally about what you ate, how you feel, or how long you slept — and the language model classifies, understands, and stores it. This is where an "ordinary journal" becomes a "journal with a brain."
State — the full picture
Phase, goals, protocol — what Box knows about you
State is Box's short-term memory — one file holding the current context: which phase you're in, what the goal is, which protocol is active. Every interaction starts by reading this state, and only then does Box respond. That's the difference between "an assistant that replies to a message" and "a coach that remembers the journey."
ICS calendar — 16:8 windows inside Google Calendar
Subscribe once and see your eating windows on your phone forever
ICS is the standard file format for calendars — exactly what Google Calendar, Apple Calendar, and Outlook know how to read. Box exposes an endpoint that returns a live ICS file (always up to date), and you subscribe to it like subscribing to a podcast. The result: your fasting and eating windows appear in the calendar you already use, without another app.
Coaching — the next steps
Not just logging — concrete recommendations
Coaching is where Box moves from "journal" to "coach." After enough data is collected (usually two weeks), the model starts identifying personal patterns and suggesting precise interventions — tailored to you, not generic advice from a book. The tone: asks and suggests, never commands, never judges.
Advanced tips
Integrations that turn this from a tool into a system
This section is for people who want to extend Box beyond basic use. Every capability here adds a real layer of convenience — reduces friction, adds automation, or opens up new use cases. You don't have to implement them all — each one stands on its own.
