CookCLI

CookCLI is an open-source application that provides command line tools and an embedded web server for managing recipes using the Cooklang format. It allows users to maintain recipe collections, generate shopping lists, and plan meals through a terminal interface or a browser. The software is deployed as a binary that can be installed via Homebrew, Cargo, or built from source, making it accessible across different operating systems.

Users interact with their recipes using a suite of CLI commands to parse files, scale ingredient quantities, and search for specific dishes. The included web server makes these recipes browsable on any device, while a build command can generate a self-contained static website for hosting or local viewing via a file system. The system also supports specialized menu files that allow users to reference recipes and inline ingredients to organize their meals by day and meal type.

Key features

• Generation of organized shopping lists from multiple recipes
• Embedded web server for browsing recipes via a browser
• Pantry tracking for inventory and expiration dates
• Recipe search across ingredients, instructions, and metadata
• Meal planning via dedicated menu files
• Static website generation for recipe collections
• Recipe validation and consistency checks
• Support for scaling ingredient quantities

The application is built with Rust and Node.js, following the UNIX philosophy where each command performs a specific task. It integrates with the Cooklang format to keep recipes in plain text, which ensures they remain compatible with other scripting tools and version control systems. The software includes a doctor command for collection maintenance and an import feature that uses an API key to convert external website recipes into the Cooklang format. Additionally, an experimental report feature allows for the generation of custom outputs, such as recipe cards or nutrition labels, using templates.

CookCLI is designed for users who prefer a text-based approach to recipe management and desire automation for their cooking and shopping routines.