From 92537b74fe88a1cca19fb688201b9833c8f6a501 Mon Sep 17 00:00:00 2001 From: dianed-square <73617011+dianed-square@users.noreply.github.com> Date: Wed, 17 Dec 2025 17:22:03 -0800 Subject: [PATCH] docs: auto download updates (#6163) --- .../docs/getting-started/installation.md | 6 +- documentation/docs/guides/updating-goose.md | 63 +++++++++---------- .../components/CLIExtensionInstructions.tsx | 2 +- .../src/components/DesktopAutoUpdateSteps.js | 23 +++++++ .../components/LinuxDesktopInstallButtons.js | 2 +- .../components/MacDesktopInstallButtons.js | 2 +- .../src/components/ModelSelectionTip.js | 2 +- .../src/components/OnboardingProviderSetup.js | 2 +- documentation/src/components/RateLimits.js | 2 +- .../src/components/SupportedEnvironments.js | 4 +- .../WindowsDesktopInstallButtons.js | 2 +- documentation/src/components/recipe-card.tsx | 4 +- 12 files changed, 67 insertions(+), 47 deletions(-) create mode 100644 documentation/src/components/DesktopAutoUpdateSteps.js diff --git a/documentation/docs/getting-started/installation.md b/documentation/docs/getting-started/installation.md index d6a71c77..ac67d496 100644 --- a/documentation/docs/getting-started/installation.md +++ b/documentation/docs/getting-started/installation.md @@ -29,7 +29,7 @@ import { PanelLeft } from 'lucide-react'; 2. Run the executable file to launch the goose Desktop application. :::tip Updating goose - It's best to keep goose updated by periodically running the installation steps again. + It's best to periodically [update goose](/docs/guides/updating-goose). :::

Option 2: Install via Homebrew

@@ -99,7 +99,7 @@ import { PanelLeft } from 'lucide-react'; 4. Launch goose from the app menu :::tip Updating goose - It's best to keep goose updated by periodically running the installation steps again. + It's best to periodically [update goose](/docs/guides/updating-goose). ::: @@ -142,7 +142,7 @@ import { PanelLeft } from 'lucide-react'; 2. Run the executable file to launch the goose Desktop application. :::tip Updating goose - It's best to keep goose updated by periodically running the installation steps again. + It's best to periodically [update goose](/docs/guides/updating-goose). ::: diff --git a/documentation/docs/guides/updating-goose.md b/documentation/docs/guides/updating-goose.md index 0bbc34b1..99388efb 100644 --- a/documentation/docs/guides/updating-goose.md +++ b/documentation/docs/guides/updating-goose.md @@ -6,6 +6,7 @@ sidebar_label: Updating goose import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; +import { DesktopAutoUpdateSteps } from '@site/src/components/DesktopAutoUpdateSteps'; import MacDesktopInstallButtons from '@site/src/components/MacDesktopInstallButtons'; import WindowsDesktopInstallButtons from '@site/src/components/WindowsDesktopInstallButtons'; import LinuxDesktopInstallButtons from '@site/src/components/LinuxDesktopInstallButtons'; @@ -16,16 +17,16 @@ The goose CLI and desktop apps are under active and continuous development. To g - :::info - To update goose to the latest stable version, reinstall using the instructions below - ::: -
- 1. - 2. Unzip the downloaded zip file. - 3. Run the executable file to launch the goose Desktop application. - 4. Overwrite the existing goose application with the new version. - 5. Run the executable file to launch the goose Desktop application. -
+ Update goose to the latest stable version. + + + + **To manually download and install updates:** + 1. + 2. Unzip the downloaded zip file + 3. Drag the extracted `Goose.app` file to the `Applications` folder to overwrite your current version + 4. Launch goose Desktop + You can update goose by running: @@ -62,19 +63,17 @@ The goose CLI and desktop apps are under active and continuous development. To g - :::info - To update goose to the latest stable version, reinstall using the instructions below - ::: -
- 1. - - **For Debian/Ubuntu-based distributions:** - 2. Download the DEB file - 3. Navigate to the directory where it is saved in a terminal - 4. Run `sudo dpkg -i (filename).deb` - 5. Launch goose from the app menu + Update goose to the latest stable version. -
+ + + **To manually download and install updates:** + 1. + + #### For Debian/Ubuntu-based distributions + 2. In a terminal, navigate to the downloaded DEB file + 3. Run `sudo dpkg -i (filename).deb` + 4. Launch goose from the app menu You can update goose by running: @@ -111,16 +110,14 @@ The goose CLI and desktop apps are under active and continuous development. To g - :::info - To update goose to the latest stable version, reinstall using the instructions below - ::: -
- 1. - 2. Unzip the downloaded zip file. - 3. Run the executable file to launch the goose Desktop application. - 4. Overwrite the existing goose application with the new version. - 5. Run the executable file to launch the goose Desktop application. -
+ Update goose to the latest stable version. + + + + **To manually download and install updates:** + 1. + 2. Unzip the downloaded zip file + 3. Run the executable file to launch the goose Desktop app You can update goose by running: @@ -164,4 +161,4 @@ The goose CLI and desktop apps are under active and continuous development. To g - \ No newline at end of file + diff --git a/documentation/src/components/CLIExtensionInstructions.tsx b/documentation/src/components/CLIExtensionInstructions.tsx index f99adfbc..6ab4168a 100644 --- a/documentation/src/components/CLIExtensionInstructions.tsx +++ b/documentation/src/components/CLIExtensionInstructions.tsx @@ -162,7 +162,7 @@ ${
  1. - Enter the number of seconds Goose should wait for actions to complete before timing out. Default is{' '} + Enter the number of seconds goose should wait for actions to complete before timing out. Default is{' '} 300 seconds.
diff --git a/documentation/src/components/DesktopAutoUpdateSteps.js b/documentation/src/components/DesktopAutoUpdateSteps.js new file mode 100644 index 00000000..f001b965 --- /dev/null +++ b/documentation/src/components/DesktopAutoUpdateSteps.js @@ -0,0 +1,23 @@ +import React from "react"; +import { PanelLeft } from "lucide-react"; + +export const DesktopAutoUpdateSteps = () => { + return ( + <> +

To automatically download and install updates:

+
    +
  1. Click the button in the top-left to open the sidebar
    2. +
  2. Click Settings in the sidebar
    3. +
  3. Click App
    4. +
  4. Scroll down to the Updates section: +
      +
    • Check if your current version is "up to date" or if a newer version is available
      • +
    • To automatically download the newer version, click Check for Updates
      • +
    +
    5. +
  5. Click Install & Restart to immediately relaunch goose Desktop and apply the update
    + Note: If the app can't be automatically updated, you'll be prompted to manually install the downloaded version
    6. +
+ + ); +}; diff --git a/documentation/src/components/LinuxDesktopInstallButtons.js b/documentation/src/components/LinuxDesktopInstallButtons.js index 3de0445d..c249b402 100644 --- a/documentation/src/components/LinuxDesktopInstallButtons.js +++ b/documentation/src/components/LinuxDesktopInstallButtons.js @@ -57,7 +57,7 @@ const LinuxDesktopInstallButtons = () => { return (
-

To download Goose Desktop for Linux, click one of the buttons below:

+

Click one of the buttons below to download goose Desktop for Linux:

{ return (
-

To download Goose Desktop for macOS, click one of the buttons below:

+

Click one of the buttons below to download goose Desktop for macOS:

{ return ( -

Goose relies heavily on tool calling capabilities and currently works best with Claude 4 models.

+

goose relies heavily on tool calling capabilities and currently works best with Claude 4 models.

); }; diff --git a/documentation/src/components/OnboardingProviderSetup.js b/documentation/src/components/OnboardingProviderSetup.js index c515d089..58fae0c6 100644 --- a/documentation/src/components/OnboardingProviderSetup.js +++ b/documentation/src/components/OnboardingProviderSetup.js @@ -18,7 +18,7 @@ export const OnboardingProviderSetup = () => {
-

You'll receive $10 in free credits the first time you automatically authenticate with Tetrate through Goose. This offer is available to both new and existing Tetrate users.

+

You'll receive $10 in free credits the first time you automatically authenticate with Tetrate through goose. This offer is available to both new and existing Tetrate users.

diff --git a/documentation/src/components/RateLimits.js b/documentation/src/components/RateLimits.js index 5a996e20..6a28b141 100644 --- a/documentation/src/components/RateLimits.js +++ b/documentation/src/components/RateLimits.js @@ -21,7 +21,7 @@ export const RateLimits = () => { Handling Rate Limits {" "} - guide to learn how to efficiently manage these limits while using Goose. + guide to learn how to efficiently manage these limits while using goose. ); }; diff --git a/documentation/src/components/SupportedEnvironments.js b/documentation/src/components/SupportedEnvironments.js index b1645cee..6b6166d0 100644 --- a/documentation/src/components/SupportedEnvironments.js +++ b/documentation/src/components/SupportedEnvironments.js @@ -4,8 +4,8 @@ import Admonition from "@theme/Admonition"; const SupportedEnvironments = () => { return ( - The Goose CLI currently works on macOS and Linux systems and supports both ARM and x86 architectures. - On Windows, Goose CLI can run via WSL, and Goose Desktop is natively supported. If you'd like to request support for additional operating systems, please{" "} + The goose CLI currently works on macOS and Linux systems and supports both ARM and x86 architectures. + On Windows, goose CLI can run via WSL, and goose Desktop is natively supported. If you'd like to request support for additional operating systems, please{" "} { return (
-

To download Goose Desktop for Windows, click the button below:

+

Click one of the buttons below to download goose Desktop for Windows:

e.stopPropagation()} > - Launch in Goose Desktop → + Launch in goose Desktop →
@@ -177,7 +177,7 @@ export function RecipeCard({ recipe }: { recipe: Recipe }) { onClick={handleSubmitParams} className="bg-purple-600 text-white px-4 py-2 rounded text-sm hover:bg-purple-700" > - Copy Goose CLI Command + Copy goose CLI Command