A GitHub repo that orders your groceries. No software. No database. No code. Just structured data files that any AI agent can read.
- Fork this repo
- Edit the files in
preferences/to match how you eat and shop - Point an AI agent at the repo (Claude Code, Perplexity Computer, ChatGPT, anything)
- Tell it: "read this repo and order my groceries"
The agent reads the contracts (what a valid order looks like), your preferences (what you eat), and your pantry (what you have). It produces a shopping list that conforms to the contract and places the order.
preferences/
dietary.yaml # what you eat
cooking.yaml # how you cook
shopping.yaml # where you shop, brand preferences
household.yaml # household size, location
goals.yaml # budget, reserve target
contracts/
shopping-list.schema.json # what a valid grocery order looks like
meal-plan.schema.json # what a valid meal plan looks like
pantry-update.schema.json # how pantry state changes
pantry/
current.md # what's on hand (hints, not a ledger)
reserve.md # shelf-stable buffer
lists/ # shopping lists go here
meals/ # meal plans go here
logs/ # purchase history goes here
The contracts define what valid output looks like — not how to produce it. An AI reads the contract and knows what a grocery order must contain. It figures out the items, quantities, and store on its own.
Each contract includes:
- purpose — what this output is for
- context — what other files to read first
- constraints — what rules to follow
- schema — what the data structure looks like
- Fork this repo
- Open
preferences/dietary.yaml— change it to match your diet - Open
preferences/shopping.yaml— add your preferred stores - Open
preferences/household.yaml— set your household size and location - Tell any AI agent: "clone this repo and order my groceries"
This repo contains zero lines of code. The AI agent is the software. The data is the product. When a better AI comes along, your data works with it automatically.
MIT