Pantry Management | Cooklang: recipe markup language

CookCLI uses a pantry.conf file to track what's already in your kitchen. When you generate a shopping list, items in your pantry are automatically excluded — so you only buy what you actually need.

Pantry support is only available in CookCLI at the moment.

The Pantry Configuration File

The file uses TOML format, organized by storage location:

[freezer]
ice_cream = &#34;1%L&#34;
frozen_peas = &#34;500%g&#34;
frozen_fruit = &#34;2%kg&#34;
ground_beef = { quantity = &#34;1%kg&#34;, frozen = &#34;2024-10-15&#34; }
chicken_stock = { quantity = &#34;4%cups&#34;, frozen = &#34;2024-10-20&#34; }
spinach = { bought = &#34;2024-11-05&#34;, expire = &#34;2024-12-05&#34;, quantity = &#34;1%kg&#34; }

[fridge]
milk = { expire = &#34;2024-11-15&#34;, quantity = &#34;2%L&#34; }
eggs = &#34;12&#34;
cheese = { expire = &#34;2024-11-20&#34; }
butter = &#34;250%g&#34;
yogurt = { quantity = &#34;500%g&#34;, expire = &#34;2024-11-18&#34; }
leftovers_beef_stew = { quantity = &#34;3%portions&#34;, made = &#34;2024-11-10&#34; }

[pantry]
rice = &#34;5%kg&#34;
pasta = &#34;1%kg&#34;
flour = &#34;5%kg&#34;
sugar = &#34;2%kg&#34;
salt = &#34;1%kg&#34;
olive_oil = &#34;1%L&#34;
canned_tomatoes = &#34;4%cans&#34;
dried_beans = &#34;2%kg&#34;

[spices]
cumin = { bought = &#34;2024-06-01&#34; }
paprika = { bought = &#34;2024-03-15&#34; }
cinnamon = &#34;1%jar&#34;
black_pepper = &#34;100%g&#34;

How It Works

Simple tracking: rice = "5%kg" records what you have. If a recipe calls for rice, it won't appear on your shopping list.

Quantity awareness: If a recipe needs 500g of flour and you have 5kg, the system knows you're covered. If you need 6 eggs and have none listed, they'll be added to the list.

Expiration dates: milk = { expire = "2024-11-15", quantity = "2%L" } tracks freshness alongside quantity.

Frozen goods: Dates like frozen = "2024-10-15" help with stock rotation.

Leftovers: Entries like leftovers_beef_stew with made dates track what needs using up.

Shopping List Integration

The pantry file plugs directly into the cook shopping-list command:

cook shopping-list --pantry pantry.conf &#34;Monday Dinner.cook&#34; &#34;Tuesday Dinner.cook&#34;

The output includes only the ingredients you need to buy, with pantry items already subtracted.

The Pantry Configuration File

How It Works

Shopping List Integration

See Also