diff --git a/documentation/docs/getting-started/using-extensions.md b/documentation/docs/getting-started/using-extensions.md index 0862288e..09baeb4d 100644 --- a/documentation/docs/getting-started/using-extensions.md +++ b/documentation/docs/getting-started/using-extensions.md @@ -72,7 +72,11 @@ Here are the built-in extensions: │ ○ Google Drive │ ○ Memory │ ● JetBrains - └ + │ + ◇ Please set the timeout for this tool (in secs): + │ 300 + │ + └ Enabled jetbrains extension ``` @@ -143,6 +147,9 @@ See available servers in the **[MCP Server Directory](https://www.pulsemcp.com/s ◇ What command should be run? │ npx -y @modelcontextprotocol/server-memory │ + ◇ Please set the timeout for this tool (in secs): + │ 300 + │ ◆ Would you like to add environment variables? │ No │ @@ -154,9 +161,11 @@ See available servers in the **[MCP Server Directory](https://www.pulsemcp.com/s 1. Click `...` in the top right corner of the Goose Desktop. 2. Select `Settings` from the menu. - 3. Under `Extensions`, click `Add` link. - 4. On the `Add Extension Manually` modal, enter the necessary details and click `Add` button - 5. Click `Add Extension` button + 3. Under `Extensions`, click `Add custom extension`. + 4. On the `Add custom extension` modal, enter the necessary details + - If adding an environment variable, click `Add` button to the right of the variable + - The `Timeout` field lets you set how long Goose should wait for a tool call from this extension to complete + 5. Click `Add` button #### Example of adding the [Knowledge Graph Memory MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/memory): * **Type**: `Standard IO` @@ -179,6 +188,7 @@ extensions: enabled: true envs: { "GITHUB_PERSONAL_ACCESS_TOKEN": "" } type: stdio + timeout: 300 ``` diff --git a/documentation/docs/quickstart.md b/documentation/docs/quickstart.md index 7f2b6cfa..68008b21 100644 --- a/documentation/docs/quickstart.md +++ b/documentation/docs/quickstart.md @@ -128,7 +128,7 @@ While you're able to manually navigate to your working directory and open the HT ```sh goose configure ``` - 3. Choose `Add extension` > `Built-in Extension` > `Computer Controller`. This [extension](https://block.github.io/goose/v1/extensions/detail/nondeveloper) enables webscraping, file caching, and automations. + 3. Choose `Add extension` > `Built-in Extension` > `Computer Controller`, and set timeout to 300s. This [extension](https://block.github.io/goose/v1/extensions/detail/nondeveloper) enables webscraping, file caching, and automations. ``` ┌ goose-configure │ @@ -138,13 +138,17 @@ While you're able to manually navigate to your working directory and open the HT ◇ What type of extension would you like to add? │ Built-in Extension │ - ◆ Which built-in extension would you like to enable? + ◇ Which built-in extension would you like to enable? │ ○ Developer Tools │ ● Computer Controller (controls for webscraping, file caching, and automations) │ ○ Google Drive │ ○ Memory │ ○ JetBrains - └ + │ + ◇ Please set the timeout for this tool (in secs): + │ 300 + │ + └ Enabled Computer Controller extension ``` 4. Now that Goose has browser capabilities, let's resume your last session: ```sh diff --git a/documentation/docs/tutorials/_template_.md b/documentation/docs/tutorials/_template_.md index 6302469f..37e634f1 100644 --- a/documentation/docs/tutorials/_template_.md +++ b/documentation/docs/tutorials/_template_.md @@ -96,7 +96,31 @@ Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on └ ``` - 5. Obtain a [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens) and paste it in. + 5. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s + ```sh + ┌ goose-configure + │ + ◇ What would you like to configure? + │ Add Extension + │ + ◇ What type of extension would you like to add? + │ Command-line Extension + │ + ◇ What would you like to call this extension? + │ {name} + │ + ◇ What command should be run? + │ {command} + │ + // highlight-start + ◆ Please set the timeout for this tool (in secs): + │ 300 + // highlight-end + │ + └ + ``` + + 6. Obtain a [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens) and paste it in. :::info When creating your access token, you can specify the repositories and granular permissions you'd like Goose to have access to. ::: @@ -115,6 +139,10 @@ Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on │ ◇ What command should be run? │ {command} + │ + ◇ Please set the timeout for this tool (in secs): + │ 300 + │ // highlight-start ◆ Would you like to add environment variables? │ Yes @@ -133,20 +161,11 @@ Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on - 1. Click `...` in the upper right corner - 2. Click `Settings` - 3. Under `Extensions`, click the `Add` link - 4. On the `Add Extension Manually` modal, enter the following: - * **Type**: `Standard IO` - * **ID**: `{name}-mcp` (_set this to whatever you want_) - * **Name**: `{name}` (_set this to whatever you want_) - * **Description**: `{name} MCP Server` (_set this to whatever you want_) - * **Command**: `{command}` - * **Environment Variables** - * **Name**: `{env_var}` - * **Value**: (_Obtain a [{env_var}](/) and paste it in._) - * Click `Add` button - 5. Click `Add Extension` button + 1. [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40hapins%2Ffigma-mcp&id=figma&name=Figma&description=Figma%20design%20tool%20integration&env=FIGMA_ACCESS_TOKEN%3DAccess%20token%20from%20Figma%20user%20settings) + 2. Press `Yes` to confirm the installation + 3. Obtain a [XYZ Access Token](/) and paste it in + 4. Click `Save Configuration` + 5. Scroll to the top and click `Exit` from the upper left corner diff --git a/documentation/docs/tutorials/computer-controller-mcp.md b/documentation/docs/tutorials/computer-controller-mcp.md index 35a19a80..21b0c9b2 100644 --- a/documentation/docs/tutorials/computer-controller-mcp.md +++ b/documentation/docs/tutorials/computer-controller-mcp.md @@ -64,6 +64,26 @@ Let Goose complete its tasks without interruption - avoid using your mouse or ke | ○ JetBrains └ Enabled Computer Controller extension ``` + + 4. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s + ```sh + ┌ goose-configure + │ + ◇ What would you like to configure? + │ Add Extension + │ + ◇ What type of extension would you like to add? + │ Built-in Extension + │ + ◆ Which built-in extension would you like to enable? + │ Computer Controller + │ + // highlight-start + ◆ Please set the timeout for this tool (in secs): + │ 300 + // highlight-end + └ Enabled Computer Controller extension + ``` 1. Click `...` in the upper right corner diff --git a/documentation/docs/tutorials/fetch-mcp.md b/documentation/docs/tutorials/fetch-mcp.md index 1db21773..d81ab1ff 100644 --- a/documentation/docs/tutorials/fetch-mcp.md +++ b/documentation/docs/tutorials/fetch-mcp.md @@ -91,7 +91,30 @@ Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on └ ``` - 5. Choose No when asked to add environment variables + 5. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s + ```sh + ┌ goose-configure + │ + ◇ What would you like to configure? + │ Add Extension + │ + ◇ What type of extension would you like to add? + │ Command-line Extension + │ + ◇ What would you like to call this extension? + │ fetch + │ + ◇ What command should be run? + │ uvx mcp-server-fetch + │ + // highlight-start + ◆ Please set the timeout for this tool (in secs): + │ 300 + // highlight-end + └ + ``` + + 6. Choose No when asked to add environment variables ```sh ┌ goose-configure @@ -108,6 +131,9 @@ Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on ◇ What command should be run? │ uvx mcp-server-fetch │ + ◇ Please set the timeout for this tool (in secs): + │ 300 + │ // highlight-start ◇ Would you like to add environment variables? │ No diff --git a/documentation/docs/tutorials/figma-mcp.md b/documentation/docs/tutorials/figma-mcp.md index 0916e50a..16fd047b 100644 --- a/documentation/docs/tutorials/figma-mcp.md +++ b/documentation/docs/tutorials/figma-mcp.md @@ -92,7 +92,31 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to └ ``` - 5. Obtain a [Figma Access Token](https://www.figma.com/developers/api#access-tokens) and paste it in. + 5. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s + ```sh + ┌ goose-configure + │ + ◇ What would you like to configure? + │ Add Extension + │ + ◇ What type of extension would you like to add? + │ Command-line Extension + │ + ◇ What would you like to call this extension? + │ figma + │ + ◇ What command should be run? + │ npx @hapins/figma-mcp + │ + // highlight-start + ◆ Please set the timeout for this tool (in secs): + │ 300 + // highlight-end + │ + └ + ``` + + 6. Obtain a [Figma Access Token](https://www.figma.com/developers/api#access-tokens) and paste it in. :::info You can generate an access token from your Figma account settings under the Personal access tokens section. ::: @@ -111,6 +135,10 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to │ ◇ What command should be run? │ npx @hapins/figma-mcp + │ + ◇ Please set the timeout for this tool (in secs): + │ 300 + │ // highlight-start ◆ Would you like to add environment variables? │ Yes diff --git a/documentation/docs/tutorials/github-mcp.md b/documentation/docs/tutorials/github-mcp.md index 9f38900d..3e125152 100644 --- a/documentation/docs/tutorials/github-mcp.md +++ b/documentation/docs/tutorials/github-mcp.md @@ -91,7 +91,31 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to └ ``` - 5. Obtain a [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens) and paste it in. + 5. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s + ```sh + ┌ goose-configure + │ + ◇ What would you like to configure? + │ Add Extension + │ + ◇ What type of extension would you like to add? + │ Command-line Extension + │ + ◇ What would you like to call this extension? + │ github + │ + ◇ What command should be run? + │ npx -y @modelcontextprotocol/server-github + │ + // highlight-start + ◆ Please set the timeout for this tool (in secs): + │ 300 + // highlight-end + │ + └ + ``` + + 6. Obtain a [GitHub Personal Access Token](https://github.com/settings/personal-access-tokens) and paste it in. :::info When creating your access token, you can specify the repositories and granular permissions you'd like Goose to have access to. ::: @@ -110,6 +134,10 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to │ ◇ What command should be run? │ npx -y @modelcontextprotocol/server-github + │ + ◇ Please set the timeout for this tool (in secs): + │ 300 + │ // highlight-start ◆ Would you like to add environment variables? │ Yes diff --git a/documentation/docs/tutorials/google-drive-mcp.md b/documentation/docs/tutorials/google-drive-mcp.md index 30b3c68a..6b831b74 100644 --- a/documentation/docs/tutorials/google-drive-mcp.md +++ b/documentation/docs/tutorials/google-drive-mcp.md @@ -145,10 +145,35 @@ You'll need to re-authenticate once a day when using the Google Drive extension. └ ``` + 5. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s + ```sh + ┌ goose-configure + │ + ◇ What would you like to configure? + │ Add Extension + │ + ◇ What type of extension would you like to add? + │ Command-line Extension + │ + ◇ What would you like to call this extension? + │ google drive + │ + ◇ What command should be run? + │ npx -y @modelcontextprotocol/server-gdrive + │ + // highlight-start + ◆ Please set the timeout for this tool (in secs): + │ 300 + // highlight-end + └ + ``` + + :::tip You may need to use absolute paths (rather than relying on shell exapansion for `~`) for the `GDRIVE_CREDENTIALS_PATH` and `GDRIVE_OAUTH_PATH`. ::: - 5. Add your environment variables + + 6. Add your environment variables ```sh ┌ goose-configure @@ -164,6 +189,10 @@ You may need to use absolute paths (rather than relying on shell exapansion for │ ◇ What command should be run? │ npx -y @modelcontextprotocol/server-gdrive + │ + ◇ Please set the timeout for this tool (in secs): + │ 300 + │ // highlight-start ◆ Would you like to add environment variables? │ Yes diff --git a/documentation/docs/tutorials/google-maps-mcp.md b/documentation/docs/tutorials/google-maps-mcp.md index 8c008dba..9f1fc4f5 100644 --- a/documentation/docs/tutorials/google-maps-mcp.md +++ b/documentation/docs/tutorials/google-maps-mcp.md @@ -88,9 +88,33 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to │ npx -y @modelcontextprotocol/server-google-maps // highlight-end └ - ``` + ``` - 5. Obtain a [Google Maps API Key](https://developers.google.com/maps/documentation/javascript/get-api-key) and paste it in. + 5. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s + ```sh + ┌ goose-configure + │ + ◇ What would you like to configure? + │ Add Extension + │ + ◇ What type of extension would you like to add? + │ Command-line Extension + │ + ◇ What would you like to call this extension? + │ Google Maps + │ + ◇ What command should be run? + │ npx -y @modelcontextprotocol/server-google-maps + │ + // highlight-start + ◆ Please set the timeout for this tool (in secs): + │ 300 + // highlight-end + └ + ``` + + + 6. Obtain a [Google Maps API Key](https://developers.google.com/maps/documentation/javascript/get-api-key) and paste it in. ```sh ┌ goose-configure @@ -106,6 +130,10 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to │ ◇ What command should be run? │ npx -y @modelcontextprotocol/server-google-maps + │ + ◇ Please set the timeout for this tool (in secs): + │ 300 + │ // highlight-start ◆ Would you like to add environment variables? │ Yes diff --git a/documentation/docs/tutorials/jetbrains-mcp.md b/documentation/docs/tutorials/jetbrains-mcp.md index e8cb5e1c..781db3e6 100644 --- a/documentation/docs/tutorials/jetbrains-mcp.md +++ b/documentation/docs/tutorials/jetbrains-mcp.md @@ -61,6 +61,28 @@ This tutorial covers how to enable and use the JetBrains MCP Server as a built-i // highlight-start │ ● JetBrains (Connect to jetbrains IDEs) // highlight-end + └ + ``` + + 4. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s + + ```sh + ┌ goose-configure + │ + ◇ What would you like to configure? + │ Add Extension + │ + ◇ What type of extension would you like to add? + │ Built-in Extension + │ + ◇ Which built-in extension would you like to enable? + │ JetBrains + │ + // highlight-start + ◆ Please set the timeout for this tool (in secs): + │ 300 + // highlight-end + │ └ Enabled jetbrains extension ``` diff --git a/documentation/docs/tutorials/knowledge-graph-mcp.md b/documentation/docs/tutorials/knowledge-graph-mcp.md index 4b0163dd..5ba31457 100644 --- a/documentation/docs/tutorials/knowledge-graph-mcp.md +++ b/documentation/docs/tutorials/knowledge-graph-mcp.md @@ -86,8 +86,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to └ ``` - 5. Add Extension - + 5. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s ```sh ┌ goose-configure │ @@ -102,6 +101,33 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to │ ◇ What command should be run? │ npx -y @modelcontextprotocol/server-memory + │ + // highlight-start + ◆ Please set the timeout for this tool (in secs): + │ 300 + // highlight-end + └ + ``` + + 6. Choose No when asked to add environment variables + ```sh + ┌ goose-configure + │ + ◇ What would you like to configure? + │ Add Extension + │ + ◇ What type of extension would you like to add? + │ Command-line Extension + │ + ◇ What would you like to call this extension? + │ knowledge graph memory + │ + ◇ What command should be run? + │ npx -y @modelcontextprotocol/server-memory + │ + ◇ Please set the timeout for this tool (in secs): + │ 300 + │ // highlight-start ◆ Would you like to add environment variables? │ No diff --git a/documentation/docs/tutorials/memory-mcp.md b/documentation/docs/tutorials/memory-mcp.md index 75fb6c7c..7213494c 100644 --- a/documentation/docs/tutorials/memory-mcp.md +++ b/documentation/docs/tutorials/memory-mcp.md @@ -58,8 +58,29 @@ This tutorial covers enabling and using the Memory MCP Server, which is a built- │ ● Memory // highlight-end | ○ JetBrains - └ Enabled Memory extension + └ ``` + + 4. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s + + ```sh + ┌ goose-configure + │ + ◇ What would you like to configure? + │ Add Extension + │ + ◇ What type of extension would you like to add? + │ Built-in Extension + │ + ◇ Which built-in extension would you like to enable? + │ Memory + │ + // highlight-start + ◆ Please set the timeout for this tool (in secs): + │ 300 + // highlight-end + └ Enabled Memory extension + ``` 1. Click `...` in the upper right corner diff --git a/documentation/docs/tutorials/puppeteer-mcp.md b/documentation/docs/tutorials/puppeteer-mcp.md index 506e72b8..99a3f67a 100644 --- a/documentation/docs/tutorials/puppeteer-mcp.md +++ b/documentation/docs/tutorials/puppeteer-mcp.md @@ -86,7 +86,30 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to └ ``` - 5. Specify no environment variables are needed + 5. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s + ```sh + ┌ goose-configure + │ + ◇ What would you like to configure? + │ Add Extension + │ + ◇ What type of extension would you like to add? + │ Command-line Extension + │ + ◇ What would you like to call this extension? + │ Puppeteer + │ + ◇ What command should be run? + │ npx -y @modelcontextprotocol/server-puppeteer + │ + // highlight-start + ◆ Please set the timeout for this tool (in secs): + │ 300 + // highlight-end + └ + ``` + + 6. Choose No when asked to add environment variables ```sh ┌ goose-configure @@ -102,6 +125,10 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to │ ◇ What command should be run? │ npx -y @modelcontextprotocol/server-puppeteer + │ + ◇ Please set the timeout for this tool (in secs): + │ 300 + │ // highlight-start ◆ Would you like to add environment variables? │ No diff --git a/documentation/docs/tutorials/tavily-mcp.md b/documentation/docs/tutorials/tavily-mcp.md index e5d4b975..24031214 100644 --- a/documentation/docs/tutorials/tavily-mcp.md +++ b/documentation/docs/tutorials/tavily-mcp.md @@ -90,7 +90,30 @@ Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on └ ``` - 5. Obtain a [Tavily API Key](https://tavily.com/) and paste it in. + 5. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s + ```sh + ┌ goose-configure + │ + ◇ What would you like to configure? + │ Add Extension + │ + ◇ What type of extension would you like to add? + │ Command-line Extension + │ + ◇ What would you like to call this extension? + │ tavily + │ + ◇ What command should be run? + │ uvx mcp-tavily + │ + // highlight-start + ◆ Please set the timeout for this tool (in secs): + │ 300 + // highlight-end + └ + ``` + + 6. Obtain a [Tavily API Key](https://tavily.com/) and paste it in. :::info You can get your API key by signing up at [tavily.com](https://app.tavily.com/) and navigating to your account settings. ::: @@ -110,6 +133,9 @@ Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on ◇ What command should be run? │ uvx mcp-tavily │ + ◇ Please set the timeout for this tool (in secs): + │ 300 + │ // highlight-start ◆ Would you like to add environment variables? │ Yes diff --git a/documentation/docs/tutorials/tutorial-extension.md b/documentation/docs/tutorials/tutorial-extension.md index d920ac0c..e0cb00c8 100644 --- a/documentation/docs/tutorials/tutorial-extension.md +++ b/documentation/docs/tutorials/tutorial-extension.md @@ -52,9 +52,29 @@ goose configure // highlight-end │ ○ Memory | ○ JetBrains -└ Enabled Tutorials extension +└ ``` +4. Enter the number of seconds Goose should wait for actions to complete before timing out. Default is 300s +```sh + ┌ goose-configure + │ + ◇ What would you like to configure? + │ Add Extension + │ + ◇ What type of extension would you like to add? + │ Built-in Extension + │ + ◇ Which built-in extension would you like to enable? + │ Tutorial + │ + // highlight-start + ◆ Please set the timeout for this tool (in secs): + │ 300 + // highlight-end + └ Enabled Tutorials extension +``` + ## Available Tutorials Currently, the following tutorials are available: