Skip to main content

Create a Recipe from Your Session

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

warning

You cannot create a recipe from an existing recipe session - the "Make Agent from this session" option will be disabled.

  1. While in the session you want to save as a recipe, click the menu icon in the top right corner
  2. Select Make Agent from this session
  3. In the dialog that appears:
    • Name the recipe
    • Provide a description
    • Some activities will be automatically generated. Add or remove as needed.
    • A set of instructions will also be automatically generated. Review and edit as needed.
  4. Copy the recipe URL and use it however you like (e.g., share it with teammates, drop it in documentation, or keep it for yourself)

Use Recipe

There are two ways to use a recipe in Goose Desktop:

  1. Direct Link

    • Click a recipe link shared with you
    • The recipe will automatically open in Goose Desktop
  2. Manual URL Entry

    • Copy a recipe URL
    • Paste it into your browser's address bar
    • You will see a prompt to "Open Goose"
    • Goose Desktop will open with the recipe
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

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)

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.