heyfood for coding agents
heyfood v0.9.0 carries its own guide, schemas, and tool descriptions. Codex and Claude can learn the exact installed interface before using it, instead of relying on a copied prompt that may be out of date.
heyfood agent describe
heyfood agent setup --target all --scope user --dry-runSetup shows its work
Agent setup is opt-in. The first command prints a plan and a digest without changing anything. Apply that exact plan only after you have reviewed it:
heyfood agent setup --target all --scope user --dry-run
heyfood agent setup --target all --scope user --apply --plan-sha256 DIGESTThe saved configuration points to the absolute path of the installed binary and records a receipt, so setup is repeatable and reversible. The current qualified hosts are Codex CLI and Claude Code.
Ten focused, read-only tools
| Tool | What it lets an agent do |
|---|---|
| Manifest | Learn the installed protocol and tool versions. |
| Status | Check whether heyfood is ready without exposing credentials. |
| Capabilities | See which account features are available. |
| Grocery list | Read the active household-aware list. |
| Grocery exclusions | Read ingredients the household avoids or never buys. |
| Menu watches | List recurring restaurant menu watches. |
| Household roster | Read only the household names you choose to share. |
| Household profile | Read one shared member profile with its exact disclosure handoff. |
| Diet catalog | Browse the available evidence-graded diet guides. |
| Diet guide | Read one grounded guide by its exact diet ID. |
You decide which household details an agent can read
Household access starts in the attached heyfood TUI. You choose a member and the level of detail to share, then heyfood gives you an exact handoff for the agent. Revoking access makes every older handoff stale, including after restart.
Agents can read only what that handoff allows. They cannot add, edit, remove, approve, or save household members, and profile access is not offered for children or members whose age is unknown.
The documentation matches the binary
heyfood agent guide
heyfood agent schema
heyfood agent doctorThese offline commands print the guidance, schemas, and diagnostics bundled with your installed version. That makes the binary—not a global AGENTS.md or CLAUDE.md file—the source an agent can check from the beginning.