From 37535a7c962764155759255e6bc459271ca8a750 Mon Sep 17 00:00:00 2001 From: Steven Leggett Date: Thu, 11 Dec 2025 17:46:51 -0500 Subject: [PATCH 1/5] docs: add Sugar MCP server tutorial Signed-off-by: Steven Leggett --- documentation/docs/mcp/sugar-mcp.mdx | 124 +++++++++++++++++++++++++++ 1 file changed, 124 insertions(+) create mode 100644 documentation/docs/mcp/sugar-mcp.mdx diff --git a/documentation/docs/mcp/sugar-mcp.mdx b/documentation/docs/mcp/sugar-mcp.mdx new file mode 100644 index 000000000000..c38ba5a1caf6 --- /dev/null +++ b/documentation/docs/mcp/sugar-mcp.mdx @@ -0,0 +1,124 @@ +--- +title: Sugar Extension +description: Add Sugar MCP Server as a goose Extension +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +import CLIExtensionInstructions from '@site/src/components/CLIExtensionInstructions'; +import GooseDesktopInstaller from '@site/src/components/GooseDesktopInstaller'; + +This tutorial covers how to add the [Sugar MCP Server](https://github.com/cdnsteve/sugar) as a goose extension to delegate development tasks to an autonomous AI system that runs in the background. + +:::tip TLDR + + + [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=sugarai-mcp&id=sugar&name=Sugar&description=Autonomous%20AI%20development%20system%20-%20delegate%20tasks%20and%20run%2024%2F7) + + + **Command** + ```sh + npx -y sugarai-mcp + ``` + + +::: + +## Configuration + +:::info +Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`. +::: + +:::info +Sugar requires Python 3.11+ and the Sugar CLI installed in your project. Install with `pip install sugarai` and initialize with `sugar init`. +::: + + + + + + + + Set SUGAR_PROJECT_ROOT to your project directory, or Sugar will use the current working directory. + + } + /> + + + +## Example Usage + +Sugar lets you delegate development tasks to an autonomous AI that works in the background. Tasks are queued and executed independently, so you can continue working while Sugar handles them. + + + + 1. Open a new session in goose Desktop + + + + 1. Open a terminal and start a new goose session: + + ```sh + goose session + ``` + + + + +### goose Prompt + +Create a task to add input validation to the user registration form. Priority 4. + +### goose Output + +:::note Desktop + +I'll create a Sugar task for adding input validation to the user registration form. + +-------- createTask ------- + +Task created successfully: +- **ID**: a1b2c3d4-5678-90ab-cdef-ghijklmnopqr +- **Title**: Add input validation to the user registration form +- **Type**: feature +- **Priority**: P4 (High) +- **Status**: pending + +The task has been queued. Sugar will pick it up and work on it autonomously. You can check the status anytime with `getStatus` or `listTasks`. + +::: + +### Available Tools + +Sugar exposes the following tools through MCP: + +| Tool | Description | +|------|-------------| +| `createTask` | Create a new development task | +| `listTasks` | List tasks with optional filtering | +| `viewTask` | View detailed task information | +| `updateTask` | Update task properties | +| `removeTask` | Remove a task from the queue | +| `getStatus` | Get system status and metrics | +| `runOnce` | Execute one autonomous development cycle | +| `initSugar` | Initialize Sugar in a project | From af1fe81b7e77f1368b22e847f671c66c0c2942ed Mon Sep 17 00:00:00 2001 From: Steven Leggett Date: Thu, 11 Dec 2025 14:18:09 -0500 Subject: [PATCH 2/5] docs: add Sugar MCP server to extensions registry Signed-off-by: Steven Leggett --- documentation/static/servers.json | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/documentation/static/servers.json b/documentation/static/servers.json index bae762ced854..ce462f5573ea 100644 --- a/documentation/static/servers.json +++ b/documentation/static/servers.json @@ -640,6 +640,23 @@ } ] }, + { + "id": "sugar", + "name": "Sugar", + "description": "Autonomous AI development system - delegate tasks, run 24/7, auto-discover work from errors and GitHub issues", + "command": "npx -y sugarai-mcp", + "link": "https://github.com/cdnsteve/sugar", + "installation_notes": "Requires Python 3.11+ and Sugar CLI: pip install sugarai && sugar init", + "is_builtin": false, + "endorsed": false, + "environmentVariables": [ + { + "name": "SUGAR_PROJECT_ROOT", + "description": "Project directory for Sugar operations (defaults to current directory)", + "required": false + } + ] + }, { "id": "tavily", "name": "Tavily Web Search", From 1ad26e6dffce3f8530b995d887921c0894bc297d Mon Sep 17 00:00:00 2001 From: Steven Leggett Date: Tue, 16 Dec 2025 08:18:15 -0500 Subject: [PATCH 3/5] Address PR review feedback - Remove deprecated cliCommand prop from GooseDesktopInstaller - Add customStep3 to provide guidance about SUGAR_PROJECT_ROOT env var - Format goose prompt as blockquote for consistency Signed-off-by: Steven Leggett --- documentation/docs/mcp/sugar-mcp.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/documentation/docs/mcp/sugar-mcp.mdx b/documentation/docs/mcp/sugar-mcp.mdx index c38ba5a1caf6..203e8cccea5f 100644 --- a/documentation/docs/mcp/sugar-mcp.mdx +++ b/documentation/docs/mcp/sugar-mcp.mdx @@ -42,8 +42,8 @@ Sugar requires Python 3.11+ and the Sugar CLI installed in your project. Install description="Autonomous AI development system - delegate tasks and run 24/7" command="npx" args={["-y", "sugarai-mcp"]} - cliCommand="npx -y sugarai-mcp" timeout={300} + customStep3="Set SUGAR_PROJECT_ROOT to your project directory (/path/to/your/project), or Sugar will use the current working directory" envVars={[ { name: "SUGAR_PROJECT_ROOT", label: "Project directory (optional, defaults to current)" } ]} @@ -87,7 +87,7 @@ Sugar lets you delegate development tasks to an autonomous AI that works in the ### goose Prompt -Create a task to add input validation to the user registration form. Priority 4. +> Create a task to add input validation to the user registration form. Priority 4. ### goose Output From 970072251cbc9923082aecd4c48790ec303fa83e Mon Sep 17 00:00:00 2001 From: Steven Leggett Date: Tue, 16 Dec 2025 08:43:31 -0500 Subject: [PATCH 4/5] Improve TLDR with clear setup guidance per platform - Desktop: clarify SUGAR_PROJECT_ROOT is needed - CLI: note it runs in current directory by default Signed-off-by: Steven Leggett --- documentation/docs/mcp/sugar-mcp.mdx | 3 +++ 1 file changed, 3 insertions(+) diff --git a/documentation/docs/mcp/sugar-mcp.mdx b/documentation/docs/mcp/sugar-mcp.mdx index 203e8cccea5f..bf83a364ed67 100644 --- a/documentation/docs/mcp/sugar-mcp.mdx +++ b/documentation/docs/mcp/sugar-mcp.mdx @@ -14,12 +14,15 @@ This tutorial covers how to add the [Sugar MCP Server](https://github.com/cdnste [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=sugarai-mcp&id=sugar&name=Sugar&description=Autonomous%20AI%20development%20system%20-%20delegate%20tasks%20and%20run%2024%2F7) + + When prompted, set `SUGAR_PROJECT_ROOT` to your project path. **Command** ```sh npx -y sugarai-mcp ``` + Runs in your current directory by default. ::: From c2dd4bbdc1fd72f1140ac3901a7814be842e8528 Mon Sep 17 00:00:00 2001 From: dianed-square <73617011+dianed-square@users.noreply.github.com> Date: Tue, 16 Dec 2025 08:06:38 -0800 Subject: [PATCH 5/5] Update documentation/docs/mcp/sugar-mcp.mdx Signed-off-by: Steven Leggett --- documentation/docs/mcp/sugar-mcp.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/docs/mcp/sugar-mcp.mdx b/documentation/docs/mcp/sugar-mcp.mdx index bf83a364ed67..dd57022f9dfb 100644 --- a/documentation/docs/mcp/sugar-mcp.mdx +++ b/documentation/docs/mcp/sugar-mcp.mdx @@ -13,7 +13,7 @@ This tutorial covers how to add the [Sugar MCP Server](https://github.com/cdnste :::tip TLDR - [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=sugarai-mcp&id=sugar&name=Sugar&description=Autonomous%20AI%20development%20system%20-%20delegate%20tasks%20and%20run%2024%2F7) + [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=sugarai-mcp&id=sugar&name=Sugar&description=Autonomous%20AI%20development%20system%20-%20delegate%20tasks%20and%20run%2024%2F7&env=SUGAR_PROJECT_ROOT%3DProject%20directory%20(optional%2C%20defaults%20to%20current)) When prompted, set `SUGAR_PROJECT_ROOT` to your project path.