CookCLI
Your recipe folder, from the terminal. Shopping lists, a local web server, search, reports and a static website — all from plain .cook files, the UNIX way.
Or grab a binary, RPM or cargo install — see all install options.
$ cook sl "Breakfast/Easy Pancakes.cook" Risotto.cook [fruit and veg] onion 1 [milk and dairy] milk 250 ml butter knob egg 3 [tinned goods and baking] flour 125 g [packaged goods, pasta and sauces] arborio rice 320 g [dried herbs and spices] salt pinch, 1 tbsp, 1 tsp saffron threads 1 pinch $ cook search tomato Salads/Caprese.cook Shared/Guacamole.cook Neapolitan Pizza.cook
cook server
Your recipes in the browser
One command turns your folder into a web app on your network: browse and search, scale recipes, build a shopping list, plan with menus and keep a pantry.
Building an integration? The server exposes an HTTP API. Want it always on? Run it on a Raspberry Pi.
Small tools that compose
Shopping lists
Combine recipes or a whole menu into one list, grouped by aisle, minus what's in your pantry.
Search
Find recipes by any word in them: an ingredient, a step or a title.
Import
Turn a recipe from a website into a clean .cook file.
Static website
Publish your collection as a searchable static site for GitHub Pages or Netlify.
Reports
Render any recipe or menu through a template: costs, nutrition, printable cards.
Pantry
See what's running low or about to expire, and what you can cook with what you have.
Doctor
Check recipes for errors, and spot ingredients missing from your aisle and pantry files.
Editor support
A language server for completion and diagnostics in VS Code, Neovim and other editors.
All commands
Full reference for every command. Install options are on the download page.
| Command | Alias | Description |
|---|---|---|
| recipe | r | Parse, validate and display recipe files |
| shopping-list | sl | Generate a combined shopping list from recipes |
| server | s | Start a web server to browse recipes |
| search | f | Search through your recipe collection |
| import | i | Import recipes from websites |
| report | rp | Generate custom reports using templates |
| doctor | Analyze recipes for issues | |
| pantry | p | Manage and analyze pantry inventory |
| build | Build a static website from your recipes | |
| seed | Initialize with example recipes | |
| lsp | Start the Language Server Protocol server | |
| update | u | Update CookCLI to the latest version |
| completions | Generate shell completion scripts |
Sync
cook login signs CookCLI in to Cook Cloud sync (Cook Basic). While cook server runs, it keeps your recipe folder in step with the Cook mobile apps and Cook Editor. cook logout signs out.
Reference
| Page | Description |
|---|---|
| Server API | HTTP endpoints exposed by cook server, for building integrations |