Skip to main content

Saving Recipes

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

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​

TypeLocationAvailabilityBest For
Global~/.config/goose/recipes/All projects and sessionsPersonal workflows, general-purpose recipes
LocalYOUR_WORKING_DIRECTORY/.goose/recipes/Only when working in that projectProject-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 button with your current model at the bottom of the window
  2. Click View Recipe
  3. Make any desired edits to the description, instructions, or initial prompts
  4. Click Save Recipe
note

When you modify and save a recipe with a new name, a new recipe and new link are generated. You can still run the original recipe from the recipe library, or using the original link. If you edit a recipe without changing its name, the version in the recipe library is updated, but you can still run the original recipe via link.

Import Recipe:

You can import a shared recipe into your Recipe Library:

  1. Click the button in the top-left to open the sidebar
  2. Click Recipes
  3. Click Import Recipe and paste in the recipe URL
  4. Add a name and choose the storage location
  5. Click Import Recipe

Finding Your Recipes​

Access Recipe Library:

  1. Click the button in the top-left to open the sidebar
  2. Click Recipes
  3. Browse the list of your saved recipes
  4. Each recipe shows its title, description, and whether it's global or local

Using Saved Recipes​

  1. Click the button in the top-left to open the sidebar
  2. Click Recipes
  3. Find your recipe in the Recipe Library
  4. Choose one of the following:
    • Click Use to run it immediately
    • Click Preview to see the recipe details first, then click Load Recipe to run it