family-food-runner
v0.1.6
Published
Local provider runner for Family Food
Downloads
1,116
Readme
Family Food Runner
The Family Food runner executes grocery and reservation provider commands on a Mac you control. Provider credentials and browser sessions stay on that Mac.
Install
npx family-food-runner@latest setupGenerate the one-time pairing code in Family Food under Settings -> Runner & integrations, enter it into the hidden setup prompt, and accept the launchd install when you want the runner to stay online.
Useful commands:
family-food-runner setup --check
family-food-runner onboard instacart --check
family-food-runner onboard reservations --check
family-food-runner install-daemon
family-food-runner uninstall-daemonState is stored in ~/.family-food-runner/. The default public Convex deployment
is https://secret-snake-98.convex.cloud; setup lets you override it.
Requires macOS for launchd integration and Node.js 20 or newer.
Capability selection
The daemon derives claimable job kinds from live provider CLI probes. By
default, leave RUNNER_CAPABILITIES unset or set it to *; both mean “claim
everything this runner build can currently verify.” A comma-separated value is
an optional restriction and is intersected with the live probe. In particular,
reservation.book is never claimed unless the reservation CLI is healthy and
TRG_ALLOW_BOOK=1 is present.
The exact safe-default list written by runner 0.1.0/0.1.1 is migrated as an unrestricted legacy snapshot, so those installations gain newly shipped job kinds after an ordinary package update and daemon restart.
