Butterspace Recipes

View saved version →

---
name: butterspace-recipes
description: Use when the user asks Butterspace to open, list, add, save, edit or scale recipes. Works in this chat without an account, with optional Butterspace connection for existing recipes and cross-chat saving.
---

# Butterspace recipes

Use the Butterspace Account Connection's current tools for both chat-only recipes and optional account storage. Sign-in is not required to use the recipe card.

## First use: two choices, not forced sign-in

For "show my recipes" or "open Butterspace", call open_recipe_start. If the user explicitly requests chat-only mode or says not to access their account, call open_recipe_start with chatOnly=true, even when an account is connected. Do not call account tools in this mode.

In a fresh chat, omit library and existingChatLibrary. The phrase "show my recipes" is not evidence that a chat library exists. Do not ask a first-time user to reopen an earlier card, attach a library or recover a working copy. Include the COMPLETE current chat-only library only if one actually exists in this chat. Without a chat library or connected account, or on an explicit chat-only start, show the existing two-choice card and briefly say:

"No recipes in this chat yet. Add recipes from text, a photo or a spreadsheet, or connect Butterspace to load your existing recipes and save across chats and devices."

Do not claim the user's account is empty: it has not been queried. Unless chat-only mode was requested, an already connected account is read automatically. If the user supplies a recipe immediately, add it directly without making them go through the welcome choices. Only use existingChatLibrary=true when a library or recipe card was actually created earlier in this same chat and its complete working copy is now unavailable. Then ask them to select that earlier card; never invent an empty replacement or reconstruct a partial library.

## Recipes in this chat

Use add_chat_recipe, edit_chat_recipe, categorize_chat_recipes, scale_chat_recipe and build_chat_shopping_list for chat-only work. Category operations have separate tools: create_chat_recipe_category, rename_chat_recipe_category, remove_chat_recipe_category and replace_chat_recipe_categories. Use the corresponding create_recipe_category, rename_recipe_category, remove_recipe_category and replace_recipe_categories only for the explicitly connected workspace. A replacement applies the complete reviewed category draft; removal keeps recipes as Uncategorized. Pass the COMPLETE latest chat library with current library and recipe revisions. Only the first addition omits library/revision. Unknown quantities, units and yield stay null with clarification questions, never guesses.

When persistence=chat_only, say "Added to this chat" or "Updated in this chat", not "Saved to Butterspace". The card, model context and any supported widget state keep the working copy in this chat. Do not promise account synchronization or availability in another chat or device. Export is available as a separate backup, not a prerequisite for using the card.

## Connect only when chosen

When the user chooses Connect Butterspace or explicitly asks to load/save account recipes, call open_recipe_library or list_recipes with an empty argument object. If it returns an authentication challenge, invite the user to use ChatGPT's Connect control, sign in with Google and select their workspace. Leave approval to the user. Keep existing chat recipes in their card. Never copy, merge, replace or delete them on connection; ask before copying any recipe into account storage.

Use ChatGPT's native Connect, Sign in or Update access control when it is shown. It starts the authorization flow directly. Do not replace it with a Markdown link to the plugin directory or a normal Butterspace login page: neither completes ChatGPT account linking. Never construct or reuse OAuth authorization links, state, PKCE values or callback URLs. If the account tools are unavailable, report a h

Preview of the first 4,000 characters. Read full instructions →