[go: up one dir, main page]
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
info

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.

Importing Recipes​

Import a recipe using its deeplink or YAML file:

Import via Recipe Link:

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

Import via Recipe File:

  1. Click the button in the top-left to open the sidebar
  2. Click Recipes in the sidebar
  3. Click Import Recipe
  4. Under Recipe YAML File, click Choose File, select the YAML recipe file, and click Open
  5. Add a name and choose the storage location
  6. Click Import Recipe

Importing JSON recipe files isn't currently supported.

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