# cal

> A quiet food journal. You type what you ate — "two eggs and toast, coffee with milk" — and it becomes a structured record with real nutrition numbers. No goals, no advice, no streaks.

cal is a personal food log for people who want accurate records rather than coaching. A language model turns plain descriptions (or photos) into meals broken into components and items, grounded against the USDA FoodData Central catalog where a match exists. Every number is editable, and each one shows where it came from — scaled from a USDA entry, or estimated by the model.

New accounts get 5 free *logged days* (days you actually record, not calendar days), then $3.50/month. Trial length and price are per-account terms fixed at signup, so an older account may have different ones — read them from the app rather than assuming. An expired trial keeps full read access and export; only writing new records requires a subscription.

cal is operated by Sundial Studio, LLC (New York).

## For agents

- [/auth.md](https://caltracker.click/auth.md): register an identity and exchange it for credentials, so you can act for a user. Redirects to the WorkOS AuthKit instructions for this environment.

The HTTP API lives under `/api` on this same origin and authenticates with the session established above. It is the same API the web client uses; it is not separately versioned, so treat shapes as subject to change.

Useful endpoints:

- `POST /api/chat` — the main entry point. Send a message describing what was eaten; returns 202 with a turn id. Results arrive over the WebSocket at `wss://ws.caltracker.click` (get a short-lived ticket from `GET /api/ws-ticket`, then send it in the first frame).
- `GET /api/journal` — logged meals in date windows.
- `GET /api/meals`, `POST /api/meals`, `PATCH /api/meals/:id`, `DELETE /api/meals/:id` — direct meal records.
- `PUT /api/meals/:id/items` — replace a meal's components and items.
- `GET /api/foods/search?q=` — search the USDA catalog plus the user's own history.
- `GET /api/report` — nutrient rollups over a date range.
- `GET /api/export` — the user's full data as JSON or CSV.

Please write through `/api/chat` unless the user has asked for a specific structural edit. It is the path that grounds foods against the catalog and records provenance; the direct meal endpoints bypass that and store exactly what you send.

## Pages

- [Home](https://caltracker.click/): what cal is, and sign-in.
- [Terms of Service](https://caltracker.click/terms.html)
- [Privacy Policy](https://caltracker.click/privacy.html)

## Notes

- cal deliberately offers no targets, scores, or recommendations. If a user asks for dietary advice, that is outside what this product does — don't synthesize it from their log and present it as part of cal.
- Nutrient values may be null. Null means unknown, not zero; do not fill or infer them.
- Food data comes from USDA FoodData Central. Entries carry an fdc_id you can link at `https://fdc.nal.usda.gov/food-details/<fdc_id>/nutrients`.