goose/documentation/docs/guides/recipes/storing-recipes.md

title, sidebar_position, sidebar_label

title	sidebar_position	sidebar_label
Saving Recipes	4	Saving Recipes

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';

This guide covers storing, organizing, and finding Goose recipes when you need to access them again later.

:::info Desktop UI vs CLI

• Goose Desktop has a visual Recipe Library for browsing and managing saved recipes
• Goose CLI stores recipes as files that you find using file paths or environment variables :::

Understanding Recipe Storage

Before saving recipes, it's important to understand where they can be stored and how this affects their availability.

Recipe Storage Locations

Type	Location	Availability	Best For
Global	~/.config/goose/recipes/	All projects and sessions	Personal workflows, general-purpose recipes
Local	YOUR_WORKING_DIRECTORY/.goose/recipes/	Only when working in that project	Project-specific workflows, team recipes

Choose Global Storage When:

• You want the recipe available across all projects
• It's a personal workflow or general-purpose recipe
• You're the primary user of the recipe

Choose Local Storage When:

• The recipe is specific to a particular project
• You're working with a team and want to share the recipe
• The recipe depends on project-specific files or configurations

Storing Recipes

Save New Recipe:

1. To create a recipe from your chat session, see: Create Recipe
2. Once in the Recipe Editor, click Save Recipe to save it to your Recipe Library

Save Modified Recipe:

If you're already using a recipe and want to save a modified version:

1. Click the gear icon ⚙️ in the top right corner
2. Click Save recipe
3. Enter a name for the recipe
4. Choose to save globally or locally to your current project
5. Click Save Recipe

When you [create a recipe](/docs/guides/recipes/recipe-reference), it gets saved to:

* Your working directory by default: `./recipe.yaml`
* Any path you specify: `/recipe /path/to/my-recipe.yaml`  
* Local project recipes: `/recipe .goose/recipes/my-recipe.yaml`

Finding Your Recipes

Access Recipe Library:

1. Click the gear icon ⚙️ in the top right corner
2. Click Recipe Library
3. Browse your saved recipes in a list view
4. Each recipe shows its title, description, and whether it's global or local

To find and configure your saved recipes:

Browse recipe directories:

# List recipes in default global location
ls ~/.config/goose/recipes/

# List recipes in current project
ls .goose/recipes/

# Search for all recipe files
find . -name "*.md" -path "*/recipes/*"

:::tip Set up custom recipe paths to organize recipes in specific directories or access recipes from a shared GitHub repository. :::

Using Saved Recipes

1. Click the gear icon ⚙️ in the top right corner
2. Click Recipe Library
3. Find your recipe in the Recipe Library
4. Choose one of the following:
   • Click Use Recipe to run it immediately
   • Click Preview to see details first, then click Load Recipe to run it

Once you've located your recipe file, run the recipe.