Food intelligence,native to your terminal.

Ask about food, compare restaurants, manage groceries, and keep each household member's needs separate.

curl -fsSL https://hey.food/install.sh | bash

heyfood v0.9.0 for macOS and Linux. Download release

Dinner for both of you.

Keep two food profiles separate. Plan one meal around the overlap.

hey.foodAsk about food, meals, restaurants, or recipes · ready · For: Meready · For: Me

Household · Add member

How are they related to you?

Choose one relationship.

› [ ] 1 Spouse [ ] 2 Partner [ ] 3 Parent [ ] 4 Child [ ] 5 Sibling [ ] 6 Grandparent [ ] 7 Friend [ ] 8 Other

1 · Spouse

Choose with arrows, then press Enter

Order with the whole table in mind.

Resolve the restaurant, read the current menu, and keep every concern attached to the right person.

hey.foodAsk about food, meals, restaurants, or recipes · ready · For: Everyoneready · For: Everyone

Notice

Household target: Everyone

Ask about a restaurant when you’re ready.

What can Sally and I order at Heirloom tonight?

See what shapes the answer.

Explore the profile, history, and connected health context behind your guidance.

hey.foodAsk about food, meals, restaurants, or recipes · ready · For: Meready · For: Me

Your food profile, recent meals, and connected context are ready.

Show me what shapes my food guidance

Commands

Food and household

Find a restaurant

heyfood ask "Find a Thai restaurant nearby that works for everyone in my household"

Compare nearby restaurants using location, menu evidence, and each household member's dietary needs.

Documentation

Check a menu item

heyfood item "pad thai at Pismo's"

Evaluate one restaurant item against the available menu and your dietary profile.

Documentation

Create a recipe

heyfood ask "Create a 30-minute Thai dinner recipe that works for everyone in my household"

Generate or adapt a recipe around time, cuisine, ingredients, nutrition goals, and household restrictions.

Documentation

Plan for the household

heyfood ask "Plan Friday dinner for everyone in my household"

Keep each person's dietary concerns visible while finding one workable meal.

Documentation

Use your dietary graph

heyfood ask "What should I order given my dietary profile?"

Ask with the allergies, conditions, diet styles, preferences, and source details saved to your profile.

Documentation

Explore a diet guide

heyfood diet show mediterranean

Read the principles and evidence behind a named diet, while keeping your personal safety needs in charge.

Documentation

Log a meal

heyfood log "I had the tofu bowl for lunch"

Record what you ate so later guidance can use your meal history.

Documentation

Check a changing menu

heyfood ask "Show me this week's menu at Abby Jane Bakeshop in Dripping Springs, Texas"

Ask for the latest verified menu from a restaurant tracked by Menu Watch.

Documentation

Grocery

Read the active list

heyfood grocery list

View the current list without creating or replacing it.

Documentation

Prepare a household-aware change

heyfood grocery add --list-id LIST_ID --version VERSION --intended-for "Maya" "oat milk"

Add an item for a specific household member, then review the proposal before saving it.

Documentation

Export the list

heyfood grocery export LIST_ID --format markdown

Send a grocery list to Markdown, plain text, or JSON.

Documentation

Terminal workflows

Set up your coding agent

heyfood agent setup --target all --scope user --dry-run

Give Codex or Claude a version-matched guide and ten read-only tools, including Diet guides and household details you choose to share. Setup is opt-in and shows its plan before changing anything.

Documentation

Continue a conversation

heyfood reply --conversation-id CONVERSATION_ID "The second option"

Reply to a known conversation without losing the prior turn.

Documentation

Pipe structured output

printf '%s\n' "What can I eat?" | heyfood ask --json

Read input from stdin and emit one ANSI-free JSON value to stdout for scripts and agents.

Documentation

Built for the terminal.

Native: One Rust binary for macOS and Linux on arm64 and x86-64.
Scriptable: JSON goes to stdout. Diagnostics go to stderr. Input can come from stdin.
Verified downloads: Release archives include checksums and version verification.
Agent-aware: Codex and Claude can discover heyfood and use ten read-only tools, including Diet guides and household details you choose to share. They never drive the TUI or approve changes for you.
Designed TUI: A calm application frame keeps progress, location, household scope, commands, and the active release clear from compact terminals to wide screens.

Safety and security.

Safety

Results explain what was found, what is unknown, and what to verify before ordering.

Safety docs

Security

Security docs

Changes

Grocery changes are shown before they are saved. Expired or mismatched confirmations are rejected.

Grocery docs