Skip to content

CookCLI ​

Recipe manager using the Cooklang markup language — write recipes as plain text and browse them through a web interface. CookCLI also handles grocery list generation and pantry management, helping you track what you need to buy and what you already have on hand.

Imageghcr.io/cooklang/cookcli:latest
Web UIhttp://your-server:9080
Config path{BASE_DIR}/cookcli/recipes
Websitecooklang.org
Source codeGitHub

Resource Impact ​

PerformanceLow — Lightweight recipe server
StorageLow — Plain text recipe files

Installation ​

sh
mithrandir install cookcli

Setup ​

Place your .cook recipe files in the {BASE_DIR}/cookcli/recipes directory. The web server will automatically pick them up.

Cooklang Markup Language ​

CookCLI uses the Cooklang specification to define recipes as plain text files. The syntax is designed to be human-readable while encoding ingredients, cookware, and timers:

Crack the @eggs{3} into a bowl.
Whisk with a #whisk{} until smooth.
Cook for ~{5%minutes}.

Learn more about the syntax in the official documentation.

Importing Recipes ​

cook.md is an online tool that converts any recipe webpage into a Cooklang-formatted .cook file. Paste a URL from your favorite cooking website and it will extract ingredients, steps, and timers into the Cooklang syntax, ready to drop into your recipes directory.

Mobile Apps ​

Cooklang has companion mobile apps for managing and viewing your recipes on the go: