From 8424d43acff9c1757e29ae3d4db74478b0019868 Mon Sep 17 00:00:00 2001
From: Adewale Abati <acekyd01@gmail.com>
Date: Thu, 20 Feb 2025 11:03:56 +0100
Subject: [PATCH] docs: updating goose (#1294)

Co-authored-by: angiejones <jones.angie@gmail.com>
---
 .../docs/guides/goose-cli-commands.md         |  2 +-
 documentation/docs/guides/updating-goose.md   | 52 +++++++++++++++++++
 2 files changed, 53 insertions(+), 1 deletion(-)
 create mode 100644 documentation/docs/guides/updating-goose.md

diff --git a/documentation/docs/guides/goose-cli-commands.md b/documentation/docs/guides/goose-cli-commands.md
index 428ce632fd..92d5d03053 100644
--- a/documentation/docs/guides/goose-cli-commands.md
+++ b/documentation/docs/guides/goose-cli-commands.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 2
+sidebar_position: 4
 ---
 # CLI Commands
 
diff --git a/documentation/docs/guides/updating-goose.md b/documentation/docs/guides/updating-goose.md
new file mode 100644
index 0000000000..312555de94
--- /dev/null
+++ b/documentation/docs/guides/updating-goose.md
@@ -0,0 +1,52 @@
+---
+sidebar_position: 2
+---
+# Updating Goose
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+import { IconDownload } from "@site/src/components/icons/download";
+import Link from "@docusaurus/Link";
+
+:::info
+To update Goose to the latest stable version, reinstall using the instructions below
+:::
+
+
+<Tabs groupId="interface">
+  <TabItem value="cli" label="Goose CLI" default>
+    You can update Goose by running the [installation](/docs/getting-started/installation) script again:
+
+    ```sh
+    curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash
+    ```
+
+    To check your current Goose version, use the following command:
+
+    ```sh
+    goose --version
+    ```
+
+  </TabItem>
+  <TabItem value="ui" label="Goose Desktop">
+        <div style={{ marginTop: '1rem' }}>
+          1. To update Goose Desktop, click the button below:
+            <div className="pill-button">
+              <Link
+                className="button button--primary button--lg"
+                to="https://github.com/block/goose/releases/download/stable/Goose.zip"
+              >
+                <IconDownload />
+                download goose desktop for macOS
+              </Link>
+            </div>
+          2. Unzip the downloaded `Goose.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.
+        </div>
+  </TabItem>
+</Tabs>
+
+All configuration settings will remain the same, with Goose updated to the latest version.
+