A recipe is an ordered list of bags and filters that generates a list of tiddlers.

They are used to create collections of tiddlers with a set of date and content customized for a particular use case.

If processing a recipe finds more than one instance of a tiddler with the same name, the tiddler from the most recent bag is the one used. This process is called the recipe cascade.

The exact storage or serialization format of a recipe is dependent on the store or serialization being used. Tools working with recipes that wish to be flexible should not rely on any format, but instead, where possible, work with recipe objects.

twanager provides a command line tool for creating recipes. As a special case, this tool uses the text serialization of a recipe as the input. That format looks like this:

That is: one line per bag/filter pair, with the optional filter represented as a URL query string. There is no upper limit on the number of bags that may be present in a recipe, but at some point it is likely to get slow.

As a special case, the bag name in a recipe may be  {{ user }} . When the recipe is processed this will be changed to the name of the current user.

Recipes may be created and updated over the HTTP API at /recipes/{recipe_name}.