From eae6e026f45e1cfa9c353b628be536258f9ed501 Mon Sep 17 00:00:00 2001 From: Diane Diaz Date: Fri, 2 Jan 2026 21:04:47 -0800 Subject: [PATCH 1/6] move slash commands --- documentation/docs/guides/config-files.md | 2 +- .../docs/guides/context-engineering/index.mdx | 5 ++ .../context-engineering/slash-commands.md | 90 +++++++++++++++++++ .../docs/guides/goose-cli-commands.md | 2 +- documentation/docs/guides/recipes/index.mdx | 7 +- .../docs/guides/recipes/session-recipes.md | 55 ++---------- documentation/docs/tutorials/rpi.md | 2 +- 7 files changed, 110 insertions(+), 53 deletions(-) create mode 100644 documentation/docs/guides/context-engineering/slash-commands.md diff --git a/documentation/docs/guides/config-files.md b/documentation/docs/guides/config-files.md index f3f62d5759a2..15beafb57e01 100644 --- a/documentation/docs/guides/config-files.md +++ b/documentation/docs/guides/config-files.md @@ -146,7 +146,7 @@ GOOSE_SEARCH_PATHS: These paths are prepended to the system PATH when running extension commands, ensuring your custom tools are found without modifying your global PATH. ## Recipe Command Configuration -You can optionally set up [custom slash commands](/docs/guides/recipes/session-recipes.md#custom-recipe-commands) to run recipes that you create. List the command (without the leading `/`) along with the path to the recipe: +You can optionally set up [custom slash commands](/docs/guides/context-engineering/slash-commands) to run recipes that you create. List the command (without the leading `/`) along with the path to the recipe: ```yaml slash_commands: diff --git a/documentation/docs/guides/context-engineering/index.mdx b/documentation/docs/guides/context-engineering/index.mdx index 5f0323d3dc13..bf5c95dccc22 100644 --- a/documentation/docs/guides/context-engineering/index.mdx +++ b/documentation/docs/guides/context-engineering/index.mdx @@ -25,6 +25,11 @@ import styles from '@site/src/components/Card/styles.module.css'; description="Create reusable instruction sets containing workflows, scripts, and other resources that goose can load on demand." link="/docs/guides/context-engineering/using-skills" /> + + + 1. Click the button in the top-left to open the sidebar + 2. Click `Recipes` in the sidebar + 3. Find the recipe you want to use and click the button + 4. In the modal that pops up, type your custom command (without the leading `/`) + 5. Click `Save` + + The command appears in purple text under the recipe in your `Recipes` menu. For recipes that aren't in your Recipe Library, follow the `goose CLI` steps. + + + + + Configure slash commands in your [configuration file](/docs/guides/config-files). List the command (without the leading `/`) along with the path to the recipe file on your computer: + +```yaml title="~/.config/goose/config.yaml" +slash_commands: + - command: "run-tests" + recipe_path: "/path/to/recipe.yaml" + - command: "daily-report" + recipe_path: "/Users/me/.local/share/goose/recipes/report.yaml" +``` + + + + +## Use Slash Commands + +In any chat session, type your custom command with a leading slash at the start of your message: + + + + +``` +/run-tests +``` + +:::tip Available Commands +Typing `/` in goose Desktop shows a popup menu with the available slash commands. +::: + + + + +```sh +Context: ●○○○○○○○○○ 5% (9695/200000 tokens) +( O)> /run-tests +``` + + + + +You can also pass one parameter after the command (if needed): + +``` +/deploy service-name +``` + +When you run a recipe using a slash command, the recipe's instructions and prompt fields are sent to your model and loaded into the conversation, but not displayed in chat. The model responds using the recipe's context and instructions just as if you opened it directly. + +## Limitations + +- Slash commands accept only one parameter. Any additional parameters in the recipe must have default values. +- Command names are case-insensitive (`/Bug` and `/bug` are treated as the same command). +- Command names must be unique and contain no spaces. +- You cannot use names that conflict with [built-in CLI slash commands](/docs/guides/goose-cli-commands#slash-commands) like `/recipe`, `/compact`, or `/help`. +- If the recipe file is missing or invalid, the command will be treated as regular text sent to the model. diff --git a/documentation/docs/guides/goose-cli-commands.md b/documentation/docs/guides/goose-cli-commands.md index d7386d536814..770e6ab61d23 100644 --- a/documentation/docs/guides/goose-cli-commands.md +++ b/documentation/docs/guides/goose-cli-commands.md @@ -600,7 +600,7 @@ Once you're in an interactive session (via `goose session` or `goose run --inter # Clear the current conversation history /clear ``` -You can also create [custom slash commands for running recipes](/docs/guides/recipes/session-recipes.md#custom-recipe-commands) in goose Desktop or the CLI. +You can also create [custom slash commands for running recipes](/docs/guides/context-engineering/slash-commands) in goose Desktop or the CLI. --- diff --git a/documentation/docs/guides/recipes/index.mdx b/documentation/docs/guides/recipes/index.mdx index 233f761d5593..5167386e0e77 100644 --- a/documentation/docs/guides/recipes/index.mdx +++ b/documentation/docs/guides/recipes/index.mdx @@ -38,6 +38,11 @@ import VideoCarousel from '@site/src/components/VideoCarousel'; description="Complete technical reference for creating and customizing recipes in goose via the CLI." link="/docs/guides/recipes/recipe-reference" /> + - \ No newline at end of file + diff --git a/documentation/docs/guides/recipes/session-recipes.md b/documentation/docs/guides/recipes/session-recipes.md index 2ce95c09b927..2ce8023a0947 100644 --- a/documentation/docs/guides/recipes/session-recipes.md +++ b/documentation/docs/guides/recipes/session-recipes.md @@ -229,6 +229,10 @@ You can turn your current goose session into a reusable recipe that includes the 3. Find your recipe in the Recipe Library 4. Click `Use` next to the recipe you want to open + **Slash Command:** + + 1. Enter a [custom slash command](/docs/guides/context-engineering/slash-commands) in any goose chat session + 2. The first time you run a recipe, a warning dialog displays the recipe's title, description, and instructions for you to review. If you trust the recipe content, click `Trust and Execute` to continue. You won't be prompted again for the same recipe unless it changes. 3. If the recipe contains parameters, enter your values in the `Recipe Parameters` dialog and click `Start Recipe`. @@ -361,6 +365,8 @@ You can turn your current goose session into a reusable recipe that includes the goose run --recipe recipe.yaml --params language=Python ``` + **Slash Command** - Enter a [custom slash command](/docs/guides/context-engineering/slash-commands) in any goose chat session + @@ -416,55 +422,6 @@ You can turn your current goose session into a reusable recipe that includes the -## Custom Recipe Commands -Create shortcuts to quickly run recipes in any goose chat session. Type a custom command like `/daily-report` to instantly apply that recipe's instructions. - - - - 1. Click the button in the top-left to open the sidebar - 2. Click `Recipes` in the sidebar - 3. Find the recipe you want to edit and click the button - 4. In the modal that pops up, type your custom command (without the leading `/`) into the text box - 5. Click `Save`. - - Once you assign a custom command, the `Recipes` menu displays that command in purple text under the recipe's creation date. Typing `/` into the goose Desktop chat window shows a popup menu with the available recipe commands. - -To run the recipe, type your custom command with a leading slash into any chat session in the desktop app: -``` -/run-tests -``` - - - - - Custom slash commands are configured in your goose [configuration file](/docs/guides/config-files.md). List the command (without the leading `/`) along with the path to the recipe: - -```yaml title="~/.config/goose/config.yaml" -slash_commands: - - command: "run-tests" - recipe_path: "/path/to/recipe.yaml" - - command: "daily-standup" - recipe_path: "/Users/me/.local/share/goose/recipes/standup.yaml" - ``` - - To run the recipe, type your custom command with a leading slash into any goose chat session: - ```sh - Context: ●○○○○○○○○○ 5% (9695/200000 tokens) - ( O)> /run-tests - ``` - - - -When you run a recipe using a slash command, the recipe's instructions and prompt fields are sent to your model and loaded into the conversation, but not displayed in chat. The model responds using the recipe's context and instructions just as if you opened it directly. - -:::info -- Custom Recipe commands don't support parameters or arguments. -- Command names are case-insensitive (`/Bug` and `/bug` are treated as the same command). -- Commands must be unique and contain no spaces. -- You cannot use names that conflict with [built-in CLI slash commands](/docs/guides/goose-cli-commands.md#slash-commands) like `/recipe`, `/compact`, or `/help`. -- If the recipe file is missing or invalid, the command will be treated as regular text sent to the model. -::: - ## Validate Recipe diff --git a/documentation/docs/tutorials/rpi.md b/documentation/docs/tutorials/rpi.md index 56c7286d1cdd..25d17b9372ab 100644 --- a/documentation/docs/tutorials/rpi.md +++ b/documentation/docs/tutorials/rpi.md @@ -38,7 +38,7 @@ curl -sL https://raw.githubusercontent.com/block/goose/main/documentation/src/pa
2. Add Custom Slash Commands -Now that the recipes are imported, to quickly invoke them in-session [add custom slash commands](/docs/guides/recipes/session-recipes/#custom-recipe-commands) for each of the following recipes: +Now that the recipes are imported, to quickly invoke them in-session [add custom slash commands](/docs/guides/context-engineering/slash-commands) for each of the following recipes: | Recipe | Slash Command | |--------|---------------| From ec657846ca72e9040fe1561eff23f60152be68c2 Mon Sep 17 00:00:00 2001 From: Diane Diaz Date: Mon, 5 Jan 2026 08:18:35 -0800 Subject: [PATCH 2/6] tweaks --- .../docs/guides/context-engineering/slash-commands.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documentation/docs/guides/context-engineering/slash-commands.md b/documentation/docs/guides/context-engineering/slash-commands.md index 29cdcca51d04..3c0be0bc1bdf 100644 --- a/documentation/docs/guides/context-engineering/slash-commands.md +++ b/documentation/docs/guides/context-engineering/slash-commands.md @@ -9,13 +9,13 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import { PanelLeft, Terminal } from 'lucide-react'; -Custom slash commands are shortcuts that let you instantly apply instructions in any goose chat session: +Custom slash commands let you instantly apply instructions using shortcuts like this: ``` /daily-report ``` -Custom slash commands save you from retyping common instructions by linking to your [recipes](/docs/guides/recipes). After creating a command, you can send it in a message to run the recipe. +Custom slash commands save you from retyping common instructions by linking to your [recipes](/docs/guides/recipes). After creating a command, use it in any goose chat session to run the recipe. ## Create Slash Commands @@ -73,7 +73,7 @@ Context: ●○○○○○○○○○ 5% (9695/200000 tokens) -You can also pass one parameter after the command (if needed): +You can pass one parameter after the command (if needed): ``` /deploy service-name @@ -83,7 +83,7 @@ When you run a recipe using a slash command, the recipe's instructions and promp ## Limitations -- Slash commands accept only one parameter. Any additional parameters in the recipe must have default values. +- Slash commands accept only one [parameter](/docs/guides/recipes/recipe-reference#parameters). Any additional parameters in the recipe must have default values. - Command names are case-insensitive (`/Bug` and `/bug` are treated as the same command). - Command names must be unique and contain no spaces. - You cannot use names that conflict with [built-in CLI slash commands](/docs/guides/goose-cli-commands#slash-commands) like `/recipe`, `/compact`, or `/help`. From a5d90cad63b42d52e212faf4237e2083ff09a59b Mon Sep 17 00:00:00 2001 From: dianed-square <73617011+dianed-square@users.noreply.github.com> Date: Mon, 5 Jan 2026 10:09:29 -0800 Subject: [PATCH 3/6] Update documentation/docs/guides/context-engineering/slash-commands.md Co-authored-by: Angie Jones --- documentation/docs/guides/context-engineering/slash-commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/docs/guides/context-engineering/slash-commands.md b/documentation/docs/guides/context-engineering/slash-commands.md index 3c0be0bc1bdf..9b291abdd85b 100644 --- a/documentation/docs/guides/context-engineering/slash-commands.md +++ b/documentation/docs/guides/context-engineering/slash-commands.md @@ -9,7 +9,7 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import { PanelLeft, Terminal } from 'lucide-react'; -Custom slash commands let you instantly apply instructions using shortcuts like this: +Custom slash commands are personalized shortcuts to run [recipes](/docs/guides/recipes). Given you have a recipe that runs a daily report, you can create a custom slash command to invoke that recipe from within a session: ``` /daily-report From 477dfe242bd3b7678a0e1073ed10ea2f76b8a55b Mon Sep 17 00:00:00 2001 From: dianed-square <73617011+dianed-square@users.noreply.github.com> Date: Mon, 5 Jan 2026 10:09:39 -0800 Subject: [PATCH 4/6] Update documentation/docs/guides/context-engineering/slash-commands.md Co-authored-by: Angie Jones --- documentation/docs/guides/context-engineering/slash-commands.md | 1 - 1 file changed, 1 deletion(-) diff --git a/documentation/docs/guides/context-engineering/slash-commands.md b/documentation/docs/guides/context-engineering/slash-commands.md index 9b291abdd85b..ec675d80f08a 100644 --- a/documentation/docs/guides/context-engineering/slash-commands.md +++ b/documentation/docs/guides/context-engineering/slash-commands.md @@ -15,7 +15,6 @@ Custom slash commands are personalized shortcuts to run [recipes](/docs/guides/r /daily-report ``` -Custom slash commands save you from retyping common instructions by linking to your [recipes](/docs/guides/recipes). After creating a command, use it in any goose chat session to run the recipe. ## Create Slash Commands From 263401d51e7547b9e79dcf7052842bf7c8d0c61a Mon Sep 17 00:00:00 2001 From: dianed-square <73617011+dianed-square@users.noreply.github.com> Date: Mon, 5 Jan 2026 10:09:58 -0800 Subject: [PATCH 5/6] Update documentation/docs/guides/context-engineering/slash-commands.md Co-authored-by: Angie Jones --- documentation/docs/guides/context-engineering/slash-commands.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/docs/guides/context-engineering/slash-commands.md b/documentation/docs/guides/context-engineering/slash-commands.md index ec675d80f08a..f425af9ac897 100644 --- a/documentation/docs/guides/context-engineering/slash-commands.md +++ b/documentation/docs/guides/context-engineering/slash-commands.md @@ -28,7 +28,7 @@ Assign a custom command to a recipe. 4. In the modal that pops up, type your custom command (without the leading `/`) 5. Click `Save` - The command appears in purple text under the recipe in your `Recipes` menu. For recipes that aren't in your Recipe Library, follow the `goose CLI` steps. + The command appears under the recipe in your `Recipes` menu. For recipes that aren't in your Recipe Library, follow the `goose CLI` steps. From b6b7ce1c8dc908f64f8e835e4e0df8db0ef905cc Mon Sep 17 00:00:00 2001 From: Diane Diaz Date: Mon, 5 Jan 2026 15:59:14 -0800 Subject: [PATCH 6/6] add topic content cards --- .../docs/guides/context-engineering/index.mdx | 5 +++ .../context-engineering/slash-commands.md | 27 +++++++++-- documentation/src/components/ContentCard.tsx | 45 ++++++++++++++++++- .../src/components/ContentCardCarousel.tsx | 2 +- 4 files changed, 74 insertions(+), 5 deletions(-) diff --git a/documentation/docs/guides/context-engineering/index.mdx b/documentation/docs/guides/context-engineering/index.mdx index bf5c95dccc22..e39255a4d345 100644 --- a/documentation/docs/guides/context-engineering/index.mdx +++ b/documentation/docs/guides/context-engineering/index.mdx @@ -35,6 +35,11 @@ import styles from '@site/src/components/Card/styles.module.css'; description="Teach goose persistent knowledge it can recall across sessions. Save commands, code snippets, and preferences for consistent assistance." link="/docs/mcp/memory-mcp" /> + diff --git a/documentation/docs/guides/context-engineering/slash-commands.md b/documentation/docs/guides/context-engineering/slash-commands.md index f425af9ac897..c949165c9d8b 100644 --- a/documentation/docs/guides/context-engineering/slash-commands.md +++ b/documentation/docs/guides/context-engineering/slash-commands.md @@ -9,7 +9,7 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import { PanelLeft, Terminal } from 'lucide-react'; -Custom slash commands are personalized shortcuts to run [recipes](/docs/guides/recipes). Given you have a recipe that runs a daily report, you can create a custom slash command to invoke that recipe from within a session: +Custom slash commands are personalized shortcuts to run [recipes](/docs/guides/recipes). If you have a recipe that runs a daily report, you can create a custom slash command to invoke that recipe from within a session: ``` /daily-report @@ -72,10 +72,10 @@ Context: ●○○○○○○○○○ 5% (9695/200000 tokens) -You can pass one parameter after the command (if needed): +You can pass one parameter after the command (if needed). Quotation marks are optional: ``` -/deploy service-name +/translator where is the library ``` When you run a recipe using a slash command, the recipe's instructions and prompt fields are sent to your model and loaded into the conversation, but not displayed in chat. The model responds using the recipe's context and instructions just as if you opened it directly. @@ -87,3 +87,24 @@ When you run a recipe using a slash command, the recipe's instructions and promp - Command names must be unique and contain no spaces. - You cannot use names that conflict with [built-in CLI slash commands](/docs/guides/goose-cli-commands#slash-commands) like `/recipe`, `/compact`, or `/help`. - If the recipe file is missing or invalid, the command will be treated as regular text sent to the model. + +## Additional Resources + +import ContentCardCarousel from '@site/src/components/ContentCardCarousel'; + + diff --git a/documentation/src/components/ContentCard.tsx b/documentation/src/components/ContentCard.tsx index c8e89226078f..62c5c5ac349c 100644 --- a/documentation/src/components/ContentCard.tsx +++ b/documentation/src/components/ContentCard.tsx @@ -1,6 +1,7 @@ import React from 'react'; +import { BookOpen } from 'lucide-react'; -type ContentType = 'video' | 'blog'; +type ContentType = 'video' | 'blog' | 'topic'; interface ContentCardProps { type: ContentType; @@ -113,6 +114,13 @@ const styles = { justifyContent: 'space-between', marginTop: 'auto', }, + + hoverBookIcon: { + width: '20px', + height: '20px', + color: 'white', + marginLeft: '4px', + }, }; export default function ContentCard({ @@ -183,6 +191,41 @@ export default function ContentCard({ }); }; + if (type === 'topic') { + const topicOverlayStyle = { + ...styles.hoverOverlay, + opacity: 1, + ...(size === 'large' ? { + padding: '2.00rem', + } : {}), + }; + + return ( + !isTouchDevice && setIsHovering(true)} + onMouseLeave={() => !isTouchDevice && setIsHovering(false)} + > +
+
+

{title}

+

{description}

+
+
+ DOCUMENTATION +
+
+
+ +
+
+
+
+ + ); + } + return (