Skip to main content

Shareable Recipes

Sometimes you finish a task in Goose and realize, "Hey, this setup could be useful again." Maybe you have curated a great combination of tools, defined a clear goal, and want to preserve that flow. Or maybe you're trying to help someone else replicate what you just did without walking them through it step by step.

You can turn your current Goose session into a reusable recipe that includes the tools, goals, and setup you're using right now and package it into a new Agent that others (or future you) can launch with a single click.

Create Recipe​

Create a recipe from the current session or from a template.

  1. While in the session you want to save as a recipe, click the button at the bottom of the app
  2. Click Create a recipe from this session
  3. A dialog opens with automatically generated instructions and activities:
    • Provide a title and description for the recipe
    • Review the instructions and edit them as needed
    • Provide an optional initial prompt to display in the chat box
    • Add or remove optional activities to display as buttons
  4. When you're finished, you can:
warning

You cannot create a recipe from an existing recipe session, but you can view or edit the recipe.

Edit Recipe​

  1. While in the session that's using the recipe, click the button at the bottom of the app
  2. Click View recipe
  3. Edit any of the following:
    • Title
    • Description
    • Instructions
    • Initial prompt
    • Activities
  4. When you're finished, you can:

Use Recipe​

  1. Open the recipe using a direct link or manual URL entry, or from your Recipe library:

    Direct Link:

    1. Click a recipe link shared with you

    Manual URL Entry:

    1. Paste a recipe link into your browser's address bar
    2. Press Enter and click the Open Goose.app prompt

    Recipe Library:

    1. Click the button in the top-left to open the sidebar
    2. Click Recipes in the sidebar
    3. Find your recipe in the Recipe Library
    4. Click Use next to the recipe you want to open

  2. If the recipe contains parameters, enter your values in the Recipe Parameters dialog and click Start Recipe.

    Parameters are dynamic values used in the recipe:

    • Required parameters are marked with red asterisks (*)
    • Optional parameters show default values that can be changed

  3. To run the recipe, click an activity bubble or send the prompt.

Parameter Creation In Goose CLI Only

You can enter parameter values to use in a recipe, but you cannot add parameters to a recipe in Goose Desktop. Parameters can only be defined in recipes created via the CLI.

Privacy & Isolation
  • Each person gets their own private session
  • No data is shared between users
  • Your session won't affect the original recipe creator's session

Validate Recipe​

Recipe validation is only available through the CLI.

Share Recipe​

Share your recipe with Desktop users by copying the recipe URL from the recipe creation dialog. When someone clicks the URL, it will open Goose Desktop with your recipe configuration.

To copy the recipe URL:

  1. Open the recipe
  2. Click the button at the bottom of the app
  3. Click View recipe
  4. Scroll down and copy the link

Schedule Recipe​

Automate Goose recipes by running them on a schedule.

  1. Click the button in the top-left to open the sidebar
  2. Click Scheduler
  3. Click Create Schedule
  4. In the dialog that appears:
    • Provide a name for the schedule
    • Select the source of your recipe. This can be either a yaml file or link generated by Goose Desktop.
    • Select whether you want your recipe to run in the background or foreground execution mode. Recipes run in the background don't open a window, but the session results are saved. Recipes run in the foreground will open a window if the Goose Desktop app is running. Otherwise, the recipe runs in the background.
    • Choose the frequency and time to run your recipe. Your selected frequency (e.g. every 20 minutes, weekly at 10 AM on Friday) is converted into a cron expression used by Goose.
    • Click Create Schedule

Your new scheduled recipe is listed in the Scheduler page. Click on the schedule to view details, see when it was last run, and perform actions with the scheduled recipe:

  • Run Schedule Now to trigger the recipe manually
  • Edit Schedule to change the scheduled frequency
  • Pause Schedule to stop the recipe from running automatically.

At the bottom of the Schedule Details page you can view the list of sessions created by the scheduled recipe and open or restore each session.

Core Components​

A recipe needs these core components:

  • Instructions: Define the agent's behavior and capabilities

    • Acts as the agent's mission statement
    • Makes the agent ready for any relevant task
    • Required if no prompt is provided

  • Prompt (Optional): Starts the conversation automatically

    • Without a prompt, the agent waits for user input
    • Useful for specific, immediate tasks
    • Required if no instructions are provided

  • Activities: Example tasks that appear as clickable bubbles

    • Help users understand what the recipe can do
    • Make it easy to get started

What's Included​

A recipe captures:

  • AI instructions (goal/purpose)
  • Suggested activities (examples for the user to click)
  • Enabled extensions and their configurations
  • Project folder or file context
  • Initial setup (but not full conversation history)
  • The model and provider to use when running the recipe (optional)

To protect your privacy and system integrity, Goose excludes:

  • Global and local memory
  • API keys and personal credentials
  • System-level Goose settings

This means others may need to supply their own credentials or memory context if the recipe depends on those elements.

Learn More​

Check out the Goose Recipes guide for more docs, tools, and resources to help you master Goose recipes.