Skip to main content

Documentation Index

Fetch the complete documentation index at: https://fromhazel.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

There are two paths to a new recipe: install one from the cookbook, or write your own.

Install from the cookbook

The cookbook is the fastest way to add a recipe. Every recipe there is maintained by Hazel and updated over time.
1

Browse or search

Open Recipes → Cookbook. Filter by category, or search by name and description.
2

Preview the instructions

Click any recipe to open the install dialog. Expand View Instructions to see exactly what Hazel will read when the recipe runs — no surprises.
3

Choose a scope

Install for Me adds it to your personal library. Install for Everyone adds it at the organization scope.
Once installed, the recipe moves from the Cookbook tab to the Installed tab. It’s enabled by default and ready to invoke.

Create a custom recipe

Custom recipes let you teach Hazel workflows unique to your business — your margin formula, your weekly review format, the way your team segments customers. From the Recipes page, click Create Recipe. You’ll fill out:
FieldRequiredNotes
NameYesShort label shown in the library and palette. Max 64 chars.
Slash commandYesWhat users type after / to invoke the recipe. Lowercase with hyphens, max 64 chars.
DescriptionYesOne or two sentences explaining when this recipe should run. Hazel uses this for auto-invocation. Max 256 chars.
CategoryYesPick the closest fit from the seven categories.
ScopeYesPersonal (default) or Organization.
InstructionsYesMarkdown body that Hazel reads when the recipe runs. Max 5,000 chars.
Custom recipes start at version v1.0. Every save bumps the minor version (v1.1, v1.2, …) so you can track how a recipe evolves.
The quality of the instructions is what makes a recipe good or bad. Before you write a big one from scratch, read Writing great recipes.

Edit an installed recipe

On any recipe detail page, click the pencil icon to edit. You can change name, slash command, description, category, and instructions. Saving bumps the recipe’s version. Edits apply immediately — the next conversation that invokes the recipe sees the new instructions.

Updating a managed recipe

When Hazel ships a new version of a managed recipe, you’ll see an amber banner at the top of the recipe detail page:
A new version (v1.3) is available for this recipe. Update
Clicking Update pulls the latest instructions from the cookbook and replaces what’s currently installed.
Updating a managed recipe overwrites any edits you’ve made. If you’ve customized the instructions and want to keep those changes, skip the update — or duplicate the customizations into a new custom recipe before updating.

Disabling and deleting

  • Disable — toggle the switch on the detail page. The recipe stays installed but is hidden from Hazel until you re-enable it.
  • Delete — click the trash icon. Deletion is permanent; you’ll need to re-install from the cookbook or re-author a custom recipe to get it back.
Personal recipes can only be deleted by the user who installed them. Organization recipes can be deleted by anyone in the org.
Next up: Writing great recipes — the practices that separate a recipe Hazel loves from one it ignores.